]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/pitch.cc
* lily/stencil-scheme.cc:
[lilypond.git] / lily / pitch.cc
index e01026da3dc764521dcf39ccdebd4459e1ce3dbb..04d7d6c127a00f191f4466ad00d709ff6a67138b 100644 (file)
@@ -1,18 +1,17 @@
-/*   
+/*
   musical-pitch.cc --  implement Pitch
-  
+
   source file of the GNU LilyPond music typesetter
-  
+
   (c) 1998--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
-  
- */
+*/
+
 #include "pitch.hh"
 #include "warn.hh"
 #include "main.hh"
 #include "ly-smobs.icc"
 
 
-
 Pitch::Pitch (int o, int n, int a)
 {
   notename_ = n;
@@ -36,11 +35,11 @@ Pitch::compare (Pitch const &m1, Pitch const &m2)
   int a = m1.alteration_ - m2.alteration_;
 
   if (o)
-       return o;
+    return o;
   if (n)
-       return n;
+    return n;
   if (a)
-       return a;
+    return a;
   return 0;
 }
 
@@ -50,9 +49,7 @@ Pitch::steps () const
   return  notename_ + octave_*7;
 }
 
-/*
-  should be settable from input?
- */
+/* Should be settable from input?  */
 static Byte diatonic_scale_semitones[  ] = { 0, 2, 4, 5, 7, 9, 11 };
 
 
@@ -70,12 +67,11 @@ Pitch::semitone_pitch () const
     }
 
   if (alteration_ % 2)
-    {
-      programming_error ("Calling semitone_pitch() for quarter tone alterations.");
-      
-    }
-  
-  return (o + n / 7) * 12 + diatonic_scale_semitones[n % 7] + (alteration_/2);
+    programming_error ("semitone_pitch () called on quarter tone alteration.");
+
+  return ((o + n / 7) * 12
+         + diatonic_scale_semitones[n % 7]
+         + (alteration_ / 2));
 }
 
 int
@@ -88,8 +84,10 @@ Pitch::quartertone_pitch () const
       n += 7;
       o --;
     }
-  
-  return (o + n / 7) * 24 +  2*  diatonic_scale_semitones[n % 7] + (alteration_);
+
+  return ((o + n / 7) * 24
+         + 2 * diatonic_scale_semitones[n % 7]
+         + alteration_);
 }
 
 void
@@ -121,7 +119,7 @@ Pitch::normalise ()
       alteration_ = 0;
       alteration_ -= quartertone_pitch () - pitch;
     }
-  
+
   while (alteration_ < DOUBLE_FLAT)
     {
       if (notename_ == 0)
@@ -141,10 +139,10 @@ Pitch::normalise ()
 void
 Pitch::transpose (Pitch delta)
 {
-  int new_semi = quartertone_pitch ()  +delta.quartertone_pitch();
+  int new_semi = quartertone_pitch ()  +delta.quartertone_pitch ();
   octave_ += delta.octave_;
   notename_ += delta.notename_;
-  alteration_ += new_semi - quartertone_pitch();
+  alteration_ += new_semi - quartertone_pitch ();
 
   normalise ();
 }
@@ -152,19 +150,18 @@ Pitch::transpose (Pitch delta)
 Pitch
 interval (Pitch const & from , Pitch const & to )
 {
-  int sound = to.quartertone_pitch()  - from.quartertone_pitch ();
+  int sound = to.quartertone_pitch ()  - from.quartertone_pitch ();
   Pitch pt (to.get_octave () - from.get_octave (),
-           to.get_notename() - from.get_notename(),
+           to.get_notename () - from.get_notename (),
 
-           to.get_alteration() - from.get_alteration());
+           to.get_alteration () - from.get_alteration ());
 
-  return pt.transposed (Pitch(0,0,sound - pt.quartertone_pitch()));
+  return pt.transposed (Pitch (0,0,sound - pt.quartertone_pitch ()));
 }
 
 
 /* FIXME
-   Merge with *pitch->text* funcs in chord-name.scm
- */
+   Merge with *pitch->text* funcs in chord-name.scm  */
 char const *accname[] = {"eses", "eseh", "es", "eh", "",
                         "ih", "is" , "isih",  "isis"};
 
@@ -192,20 +189,19 @@ Pitch::to_string () const
   return s;
 }
 
-/*
-  change me to relative, counting from last pitch p
-  return copy of resulting pitch
- */
+/* Change me to relative, counting from last pitch p
+   return copy of resulting pitch.  */
 Pitch
 Pitch::to_relative_octave (Pitch p) const
 {
-  int oct_mod = octave_  + 1;  // account for c' = octave 1 iso. 0 4
+  /* account for c' = octave 1 iso. 0 4 */
+  int oct_mod = octave_  + 1;
   Pitch up_pitch (p);
   Pitch down_pitch (p);
 
   up_pitch.alteration_ = alteration_;
   down_pitch.alteration_ = alteration_;
-  
+
   Pitch n = *this;
   up_pitch.up_to (notename_);
   down_pitch.down_to (notename_);
@@ -215,7 +211,7 @@ Pitch::to_relative_octave (Pitch p) const
     n = up_pitch;
   else
     n = down_pitch;
-  
+
   n.octave_ += oct_mod;
   return n;
 }
@@ -223,10 +219,8 @@ Pitch::to_relative_octave (Pitch p) const
 void
 Pitch::up_to (int notename)
 {
-  if (notename_  > notename)
-    {
-      octave_ ++;
-    }
+  if (notename_ > notename)
+    octave_++;
   notename_  = notename;
 }
 
@@ -234,29 +228,22 @@ void
 Pitch::down_to (int notename)
 {
   if (notename_ < notename)
-    {
-      octave_ --;
-    }
+    octave_--;
   notename_ = notename;
 }
-LY_DEFINE(ly_pitch_transpose,
-         "ly:pitch-transpose", 2, 0, 0,
-         (SCM p, SCM delta),
-         "Transpose @var{p} by the amount @var{delta}, where @var{delta} is the "
-" pitch that central C is transposed to.")
+
+LY_DEFINE (ly_pitch_transpose, "ly:pitch-transpose",
+          2, 0, 0, (SCM p, SCM delta),
+          "Transpose @var{p} by the amount @var{delta}, "
+          "where @var{delta} is the pitch that middle C is transposed to.")
 {
   Pitch* t = unsmob_pitch (p);
   Pitch *d = unsmob_pitch (delta);
-  SCM_ASSERT_TYPE(t, p, SCM_ARG1, __FUNCTION__, "pitch")  ;
-  SCM_ASSERT_TYPE(d, delta, SCM_ARG1, __FUNCTION__, "pitch")  ;
-
+  SCM_ASSERT_TYPE (t, p, SCM_ARG1, __FUNCTION__, "pitch");
+  SCM_ASSERT_TYPE (d, delta, SCM_ARG1, __FUNCTION__, "pitch");
   return t->transposed (*d).smobbed_copy ();
 }
 
-/****************************************************************/
-
-
 IMPLEMENT_TYPE_P (Pitch, "ly:pitch?");
 
 SCM
@@ -269,20 +256,18 @@ IMPLEMENT_SIMPLE_SMOBS (Pitch);
 int
 Pitch::print_smob (SCM s, SCM port, scm_print_state *)
 {
-  Pitch  *r = (Pitch *) ly_cdr (s);
-     
+  Pitch *r = (Pitch *) ly_cdr (s);
   scm_puts ("#<Pitch ", port);
   scm_display (scm_makfrom0str (r->to_string ().to_str0 ()), port);
   scm_puts (" >", port);
-  
   return 1;
 }
 
 SCM
 Pitch::equal_p (SCM a , SCM b)
 {
-  Pitch  *p = (Pitch *) ly_cdr (a);
-  Pitch  *q = (Pitch *) ly_cdr (b);  
+  Pitch *p = (Pitch *) ly_cdr (a);
+  Pitch *q = (Pitch *) ly_cdr (b);
 
   bool eq = p->notename_ == q->notename_
     && p->octave_ == q->octave_
@@ -304,100 +289,94 @@ Pitch::less_p (SCM p1, SCM p2)
     return SCM_BOOL_F;
 }
 
-/*
-  should add optional args
- */
-
-LY_DEFINE(make_pitch, "ly:make-pitch", 3, 0, 0, 
-         (SCM octave, SCM note, SCM alter),
-         "@var{octave} is specified by an integer, zero for the octave containing "
-         "middle C.  @var{note} is a number from 0 to 6, with 0 corresponding to C "
-         "and 6 corresponding to B.  The @var{alter} is zero for a natural, negative for "
-         "flats, or positive for sharps. ")
+/* Should add optional args.  */
+LY_DEFINE (make_pitch, "ly:make-pitch",
+          3, 0, 0, (SCM octave, SCM note, SCM alter),
+          "@var{octave} is specified by an integer, "
+          "zero for the octave containing middle C.  "
+          "@var{note} is a number from 0 to 6, "
+          "with 0 corresponding to C and 6 corresponding to B.  "
+          "The @var{alter} is zero for a natural, negative for "
+          "flats, or positive for sharps. ")
 {
-  SCM_ASSERT_TYPE(scm_integer_p (octave)== SCM_BOOL_T , octave, SCM_ARG1, __FUNCTION__, "integer");
-  SCM_ASSERT_TYPE(scm_integer_p (note)== SCM_BOOL_T, note, SCM_ARG2, __FUNCTION__, "integer");
-  SCM_ASSERT_TYPE(scm_integer_p (alter)== SCM_BOOL_T, alter, SCM_ARG3, __FUNCTION__, "integer");
+  SCM_ASSERT_TYPE (scm_integer_p (octave)== SCM_BOOL_T , octave, SCM_ARG1, __FUNCTION__, "integer");
+  SCM_ASSERT_TYPE (scm_integer_p (note)== SCM_BOOL_T, note, SCM_ARG2, __FUNCTION__, "integer");
+  SCM_ASSERT_TYPE (scm_integer_p (alter)== SCM_BOOL_T, alter, SCM_ARG3, __FUNCTION__, "integer");
 
   Pitch p (gh_scm2int (octave), gh_scm2int (note), gh_scm2int (alter));
   return p.smobbed_copy ();
 }
 
-LY_DEFINE(pitch_steps, "ly:pitch-steps", 1, 0,0,
-         (SCM p),
-         "Number of steps counted from central C of the pitch @var{p}.")
+LY_DEFINE (pitch_steps, "ly:pitch-steps", 1, 0, 0,
+          (SCM p),
+          "Number of steps counted from middle C of the pitch @var{p}.")
 {
   Pitch *pp = unsmob_pitch (p);
-  SCM_ASSERT_TYPE(pp, p, SCM_ARG1, __FUNCTION__, "Pitch");
-
-  return gh_int2scm (pp->steps());
+  SCM_ASSERT_TYPE (pp, p, SCM_ARG1, __FUNCTION__, "Pitch");
+  return gh_int2scm (pp->steps ());
 }
 
-LY_DEFINE(pitch_octave, "ly:pitch-octave", 1, 0, 0, 
-         (SCM pp),
-         "extract the octave from pitch @var{p}.")
+LY_DEFINE (pitch_octave, "ly:pitch-octave",
+          1, 0, 0, (SCM pp),
+          "extract the octave from pitch @var{p}.")
 {
   Pitch *p = unsmob_pitch (pp);
-  SCM_ASSERT_TYPE(p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
   int q = p->get_octave ();
-
   return gh_int2scm (q);
 }
 
-LY_DEFINE(pitch_alteration, "ly:pitch-alteration", 1, 0, 0, 
-         (SCM pp),
-         "extract the alteration from pitch  @var{p}.")
+LY_DEFINE (pitch_alteration, "ly:pitch-alteration",
+          1, 0, 0, (SCM pp),
+          "extract the alteration from pitch  @var{p}.")
 {
   Pitch *p = unsmob_pitch (pp);
-  SCM_ASSERT_TYPE(p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
-  int     q = p->get_alteration ();
+  SCM_ASSERT_TYPE (p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
+  int q = p->get_alteration ();
 
   return gh_int2scm (q);
 }
 
-LY_DEFINE(pitch_notename, "ly:pitch-notename", 1, 0, 0, 
-         (SCM pp),
-         "extract the note name from pitch  @var{pp}.")
+LY_DEFINE (pitch_notename, "ly:pitch-notename",
+          1, 0, 0, (SCM pp),
+          "extract the note name from pitch  @var{pp}.")
 {
   Pitch *p = unsmob_pitch (pp);
-  SCM_ASSERT_TYPE(p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
-  int q  = p->get_notename ();
-
+  SCM_ASSERT_TYPE (p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
+  int q = p->get_notename ();
   return gh_int2scm (q);
 }
 
-LY_DEFINE(ly_pitch_quartertones,  "ly:pitch-quartertones", 1, 0, 0, 
-         (SCM pp),
-         "calculate the number of semitones of @var{p} from central C.")
+LY_DEFINE (ly_pitch_quartertones,  "ly:pitch-quartertones",
+          1, 0, 0, (SCM pp),
+          "calculate the number of semitones of @var{p} from middle C.")
 {
   Pitch *p = unsmob_pitch (pp);
-  SCM_ASSERT_TYPE(p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
   int q = p->quartertone_pitch ();
-  
   return gh_int2scm (q);
 }
 
-LY_DEFINE(ly_pitch_semitones,  "ly:pitch-semitones", 1, 0, 0, 
-         (SCM pp),
-         "calculate the number of semitones of @var{p} from central C.")
+LY_DEFINE (ly_pitch_semitones,  "ly:pitch-semitones",
+          1, 0, 0, (SCM pp),
+          "calculate the number of semitones of @var{p} from middle C.")
 {
   Pitch *p = unsmob_pitch (pp);
-  SCM_ASSERT_TYPE(p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (p, pp, SCM_ARG1, __FUNCTION__, "Pitch");
   int q = p->semitone_pitch ();
-  
   return gh_int2scm (q);
 }
 
-LY_DEFINE(pitch_less, "ly:pitch<?", 2,0,0, (SCM p1, SCM p2),
-         "Is @var{p1} lower than @var{p2}? This uses lexicographic ordening.")
+LY_DEFINE (pitch_less, "ly:pitch<?",
+          2, 0, 0, (SCM p1, SCM p2),
+          "Is @var{p1} lower than @var{p2}? "
+          "This uses lexicographic ordening.")
 {
   Pitch *a = unsmob_pitch (p1);
   Pitch *b = unsmob_pitch (p2);
-  
-  SCM_ASSERT_TYPE(a, p1, SCM_ARG1, __FUNCTION__, "Pitch");
-  SCM_ASSERT_TYPE(b, p2, SCM_ARG2, __FUNCTION__, "Pitch");
+
+  SCM_ASSERT_TYPE (a, p1, SCM_ARG1, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (b, p2, SCM_ARG2, __FUNCTION__, "Pitch");
 
   if (Pitch::compare (*a, *b) < 0)
     return SCM_BOOL_T;
@@ -405,24 +384,23 @@ LY_DEFINE(pitch_less, "ly:pitch<?", 2,0,0, (SCM p1, SCM p2),
     return SCM_BOOL_F;
 }
 
-LY_DEFINE(ly_pitch_diff, "ly:pitch-diff", 2 ,0 ,0,
-         (SCM pitch, SCM  root),
-         "Return pitch @var{delta} such that @code{pitch} transposed by "
-         "@var{delta} equals @var{root}"
-         )
+LY_DEFINE (ly_pitch_diff, "ly:pitch-diff",
+          2 ,0, 0, (SCM pitch, SCM  root),
+          "Return pitch @var{delta} such that @code{pitch} transposed by "
+          "@var{delta} equals @var{root}" )
 {
   Pitch *p = unsmob_pitch (pitch);
   Pitch *r = unsmob_pitch (root);
-  SCM_ASSERT_TYPE(p, pitch, SCM_ARG1, __FUNCTION__, "Pitch");
-  SCM_ASSERT_TYPE(r, root, SCM_ARG2, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (p, pitch, SCM_ARG1, __FUNCTION__, "Pitch");
+  SCM_ASSERT_TYPE (r, root, SCM_ARG2, __FUNCTION__, "Pitch");
 
-  return interval (*r,  *p).smobbed_copy();
+  return interval (*r, *p).smobbed_copy ();
 }
 
 SCM
 Pitch::smobbed_copy ()const
 {
-  Pitch *  p = new Pitch (*this);
+  Pitch *p = new Pitch (*this);
   return p->smobbed_self ();
 }
 
@@ -447,7 +425,7 @@ Pitch::get_alteration () const
 Pitch
 Pitch::transposed (Pitch d) const
 {
-  Pitch p =*this;
+  Pitch p = *this;
   p.transpose (d);
   return p;
 }