lily/include/music.hh

   1 /*
   2   music.hh -- declare Music
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c)  1997--2000 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   7 */
   8
   9
  10
  11 #ifndef MUSIC_HH
  12 #define MUSIC_HH
  13
  14 #include "virtual-methods.hh"
  15 #include "minterval.hh"
  16 #include "lily-proto.hh"
  17 #include "string.hh"
  18 #include "smobs.hh"
  19
  20 /** Music is anything that has duration and supports both time compression and
  21   transposition.
  22
  23   In Lily, everything that can be thought to have a length and a pitch
  24   (which has a duration which can be transposed) is considered "music",
  25
  26   Music is hierarchical:
  27
  28   @see Music_sequence
  29
  30   */
  31 class Music {
  32 public:
  33   Input *origin () const;
  34   void set_spot (Input);
  35
  36   SCM get_mus_property (const char*) const;
  37   SCM get_mus_property (SCM) const;
  38   void set_mus_property (const char * , SCM val);
  39   void set_immutable_mus_property (const char * , SCM val);
  40   void set_immutable_mus_property (SCM key, SCM val);
  41   void set_mus_property (SCM , SCM val);
  42   void set_mus_pointer (const char*, SCM val);
  43   SCM remove_mus_property (const char* nm);
  44
  45   virtual Musical_pitch to_relative_octave (Musical_pitch);
  46
  47   /// The duration of this piece of music
  48   virtual Moment length_mom () const;
  49
  50   void print() const;
  51   /// Transpose, with the interval central C to #p#
  52   virtual void transpose (Musical_pitch p);
  53
  54   /// Scale the music in time by #factor#.
  55   virtual void compress (Moment factor);
  56   VIRTUAL_COPY_CONS(Music);
  57   Music (Music const &m);
  58   Music();
  59 protected:
  60   virtual void do_print() const;
  61   DECLARE_SMOBS(Music,);
  62   SCM immutable_property_alist_;
  63   SCM mutable_property_alist_;
  64
  65 };
  66
  67
  68 Music * unsmob_music (SCM);
  69 #endif // MUSIC_HH
  70
  71
  72