lily/pitch-scheme.cc

   1 /*
   2   pitch-scheme.cc -- implement scheme functions for Pitch
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 2005--2007 Han-Wen Nienhuys <hanwen@xs4all.nl>
   7 */
   8
   9 #include "pitch.hh"
  10
  11 LY_DEFINE (ly_pitch_transpose, "ly:pitch-transpose",
  12            2, 0, 0, (SCM p, SCM delta),
  13            "Transpose @var{p} by the amount @var{delta}, "
  14            "where @var{delta} is relative to middle C.")
  15 {
  16   LY_ASSERT_SMOB (Pitch, p, 1);
  17   LY_ASSERT_SMOB (Pitch, delta, 2);
  18
  19   Pitch *t = unsmob_pitch (p);
  20   Pitch *d = unsmob_pitch (delta);
  21   return t->transposed (*d).smobbed_copy ();
  22 }
  23
  24 /* Should add optional args.  */
  25 LY_DEFINE (ly_make_pitch, "ly:make-pitch",
  26            2, 1, 0, (SCM octave, SCM note, SCM alter),
  27            "@var{octave} is specified by an integer, "
  28            "zero for the octave containing middle C.  "
  29            "@var{note} is a number from 0 to 6, "
  30            "with 0 corresponding to C and 6 corresponding to B.  "
  31            "The @var{alter} is a rational number of whole tones for alteration.")
  32 {
  33   LY_ASSERT_TYPE (scm_is_integer, octave, 1);
  34   LY_ASSERT_TYPE (scm_is_integer, note, 2);
  35   LY_ASSERT_TYPE (scm_is_rational, alter, 3);
  36
  37   Pitch p (scm_to_int (octave), scm_to_int (note),
  38            ly_scm2rational (alter));
  39
  40   return p.smobbed_copy ();
  41 }
  42
  43 LY_DEFINE (ly_pitch_negate, "ly:pitch-negate", 1, 0, 0,
  44            (SCM p),
  45            "Negate @var{p}.")
  46 {
  47   LY_ASSERT_SMOB (Pitch, p, 1);
  48   Pitch *pp = unsmob_pitch (p);
  49   return pp->negated ().smobbed_copy ();
  50 }
  51
  52 LY_DEFINE (ly_pitch_steps, "ly:pitch-steps", 1, 0, 0,
  53            (SCM p),
  54            "Number of steps counted from middle C of the pitch @var{p}.")
  55 {
  56   LY_ASSERT_SMOB (Pitch, p, 1);
  57   Pitch *pp = unsmob_pitch (p);
  58   return scm_from_int (pp->steps ());
  59 }
  60
  61 LY_DEFINE (ly_pitch_octave, "ly:pitch-octave",
  62            1, 0, 0, (SCM pp),
  63            "Extract the octave from pitch @var{p}.")
  64 {
  65   LY_ASSERT_SMOB (Pitch, pp, 1);
  66   Pitch *p = unsmob_pitch (pp);
  67   int q = p->get_octave ();
  68   return scm_from_int (q);
  69 }
  70
  71 LY_DEFINE (ly_pitch_alteration, "ly:pitch-alteration",
  72            1, 0, 0, (SCM pp),
  73            "Extract the alteration from pitch  @var{p}.")
  74 {
  75   LY_ASSERT_SMOB (Pitch, pp, 1);
  76   Pitch *p = unsmob_pitch (pp);
  77   Rational q = p->get_alteration ();
  78
  79   return ly_rational2scm (q);
  80 }
  81
  82 LY_DEFINE (pitch_notename, "ly:pitch-notename",
  83            1, 0, 0, (SCM pp),
  84            "Extract the note name from pitch  @var{pp}.")
  85 {
  86   LY_ASSERT_SMOB (Pitch, pp, 1);
  87   Pitch *p = unsmob_pitch (pp);
  88   int q = p->get_notename ();
  89   return scm_from_int (q);
  90 }
  91
  92 LY_DEFINE (ly_pitch_quartertones, "ly:pitch-quartertones",
  93            1, 0, 0, (SCM pp),
  94            "Calculate the number of quarter tones of @var{p} from middle C.")
  95 {
  96   LY_ASSERT_SMOB (Pitch, pp, 1);
  97   Pitch *p = unsmob_pitch (pp);
  98   int q = p->rounded_quartertone_pitch ();
  99   return scm_from_int (q);
 100 }
 101
 102 LY_DEFINE (ly_pitch_semitones, "ly:pitch-semitones",
 103            1, 0, 0, (SCM pp),
 104            "calculate the number of semitones of @var{p} from middle C.")
 105 {
 106   LY_ASSERT_SMOB (Pitch, pp, 1);
 107   Pitch *p = unsmob_pitch (pp);
 108   int q = p->rounded_semitone_pitch ();
 109   return scm_from_int (q);
 110 }
 111
 112 LY_DEFINE (ly_pitch_less_p, "ly:pitch<?",
 113            2, 0, 0, (SCM p1, SCM p2),
 114            "Is @var{p1} lexicographically smaller than @var{p2}?")
 115 {
 116   LY_ASSERT_SMOB (Pitch, p1, 1);
 117   LY_ASSERT_SMOB (Pitch, p2, 2);
 118
 119   Pitch *a = unsmob_pitch (p1);
 120   Pitch *b = unsmob_pitch (p2);
 121
 122   if (Pitch::compare (*a, *b) < 0)
 123     return SCM_BOOL_T;
 124   else
 125     return SCM_BOOL_F;
 126 }
 127
 128 LY_DEFINE (ly_pitch_diff, "ly:pitch-diff",
 129            2, 0, 0, (SCM pitch, SCM root),
 130            "Return pitch @var{delta} such that @code{pitch} transposed by "
 131            "@var{delta} equals @var{root}")
 132 {
 133
 134   LY_ASSERT_SMOB (Pitch, pitch, 1);
 135   LY_ASSERT_SMOB (Pitch, root, 2);
 136
 137   Pitch *p = unsmob_pitch (pitch);
 138   Pitch *r = unsmob_pitch (root);
 139
 140   return pitch_interval (*r, *p).smobbed_copy ();
 141 }