lily/include/musical-pitch.hh

   1 /*
   2   musical-pitch.hh -- declare Musical_pitch
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1998--1999 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   7
   8  */
   9
  10 #ifndef MUSICAL_PITCH_HH
  11 #define MUSICAL_PITCH_HH
  12
  13 #include "lily-proto.hh"
  14 #include "input.hh"
  15 #include "lily-guile.hh" // we need SCM
  16
  17 /** A "tonal" pitch. This is a pitch as it figures in diatonal western
  18    music (12 semitones in an octave), as opposed to a frequence in Hz
  19    or a integer number of semitones.
  20
  21    It is not Music because, it has no duration associated.
  22 */
  23 struct Musical_pitch : public Input
  24 {
  25   Musical_pitch (int notename=0, int accidental=0, int octave=0);
  26
  27   /// 0 is c, 6 is b
  28   int notename_i_;
  29   /// 0 natural, 1 sharp, etc
  30   int accidental_i_;
  31   /// 0 is central c
  32   int octave_i_;
  33
  34   Musical_pitch to_relative_octave (Musical_pitch);
  35   void transpose (Musical_pitch);
  36   static int compare (Musical_pitch const&,Musical_pitch const&);
  37   /// return large part of interval from central c
  38   int steps() const;
  39   /// return pitch from central c (in halfnotes)
  40   int semitone_pitch() const;
  41   void up_to (int);
  42   void down_to (int);
  43   String str () const;
  44   void print () const;
  45 };
  46
  47 SCM to_scm (Musical_pitch p);
  48 void scm_to (SCM s, Musical_pitch* p);
  49
  50 #include "compare.hh"
  51 INSTANTIATE_COMPARE(Musical_pitch, Musical_pitch::compare);
  52
  53 #endif /* MUSICAL_PITCH_HH */
  54