lily/include/new-repeated-music.hh

   1 /*
   2   new-repeated-music.hh -- declare New_repeated_music
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1999 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   7
   8  */
   9
  10 #ifndef NEW_REPEATED_MUSIC_HH
  11 #define NEW_REPEATED_MUSIC_HH
  12
  13 #include "music.hh"
  14
  15
  16 /**
  17    Musical repeats.
  18
  19    A repeat, when played has the form of BODY A BODY B BODY C.
  20
  21    In this examples, the list {A B C} is put in ALTERNATIVES_P_.  BODY
  22    is put in REPEAT_BODY_P_.  Either the body or the alternative may
  23    be omitted.
  24
  25    There are three modes of representing this  music:
  26
  27    BODY A
  28         B
  29         C
  30
  31    is called "folded". Mostly used for lyrics.
  32
  33
  34    BODY A B C
  35
  36    is called "semi" folded.  This is common notation
  37
  38    BODY A BODY B BODY C
  39
  40    is called unfolded.  Useful for MIDI.
  41
  42
  43    If the number of repeats is smaller than the number of alternatives, then
  44
  45    FIXME
  46
  47    If the number of repeats is bigger than the number of alternatives, then
  48
  49    FIXME
  50
  51 */
  52 class New_repeated_music : public Music
  53 {
  54 public:
  55   bool fold_b_;
  56   /// if FOLD_B_ is false, semifold this.
  57   bool semi_fold_b_;
  58
  59   /// how often do we repeat?
  60   int repeats_i_;
  61
  62   Music * repeat_body_p_;
  63   Music_sequence * alternatives_p_;
  64
  65   virtual Musical_pitch to_relative_octave (Musical_pitch);
  66
  67   /// The duration of this piece of music
  68   virtual Moment length_mom () const;
  69
  70   Moment alternatives_length_mom () const;
  71
  72   void print() const;
  73   /// Transpose, with the interval central C to #p#
  74   virtual void transpose (Musical_pitch p);
  75
  76   /// Scale the music in time by #factor#.
  77   virtual void compress (Moment factor);
  78   VIRTUAL_COPY_CONS(Music);
  79
  80   New_repeated_music (Music*, int , Music_sequence*);
  81   New_repeated_music (New_repeated_music const&);
  82   ~New_repeated_music ();
  83 protected:
  84   virtual void do_print() const;
  85 };
  86
  87
  88 #endif /* NEW_REPEATED_MUSIC_HH */