release: 1.3.107

[lilypond.git] / lily / include / repeated-music.hh

diff --git a/lily/include/repeated-music.hh b/lily/include/repeated-music.hh
index 1528f5810b195c2d9375a15c826e81d9ac1e1510..b222111fe4368b3dbc5712c2b1743505551428d0 100644 (file)
--- a/lily/include/repeated-music.hh
+++ b/lily/include/repeated-music.hh
@@ -3,37 +3,76 @@
   
   source file of the GNU LilyPond music typesetter
   
-  (c) 1998 Jan Nieuwenhuizen <janneke@gnu.org>
+  (c) 1999--2000 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   
  */
 
-#ifndef REPEATED_MUSIC_HH
-#define REPEATED_MUSIC_HH
+#ifndef RepEATED_MUSIC_HH
+#define RepEATED_MUSIC_HH
+
+#include "music.hh"
 
-#include "music-list.hh"
 
 /**
-   Repeats and voltas
- */
+   Musical repeats.
+
+   A repeat, when played has the form of BODY A BODY B BODY C.
+
+   In this examples, the list {A B C} is put in ALTERNATIVES_P_.  BODY
+   is put in REPEAT_BODY_P_.  Either the body or the alternative may
+   be omitted.
+
+   There are three modes of representing this  music:
+
+   BODY A
+        B
+       C
+
+   is called "folded". Mostly used for lyrics.
+
+   
+   BODY A B C
+
+   is called volta.  This is common notation
+
+   BODY A BODY B BODY C
+
+   is called unfolded.  Useful for MIDI.
+
+   If the number of repeats is smaller than the number of alternatives, then
+   the excess alternatives are ignored for all timing purposes.
+
+   If the number of repeats is bigger than the number of alternatives, then
+   the first alternative is assumed to be repeated.
+   
+*/
 class Repeated_music : public Music
 {
 public:
-  int repeats_i_;
-  Music* repeat_p_;
-//  Music_list* alternative_p_;
-  Music_sequence* alternative_p_;
-
-//  Repeated_music (Music*, int n, Music_list*);
-  Repeated_music (Music*, int n, Music_sequence*);
-  Repeated_music (Repeated_music const& s);
-  virtual ~Repeated_music ();
+  Music * body () const;
+  Music_sequence * alternatives () const;
+
+  /// how often do we repeat?
+  int repeat_count( ) const;
+  virtual Musical_pitch to_relative_octave (Musical_pitch);
+
+  Moment body_length_mom () const;
+  Moment alternatives_length_mom (bool fold) const;
+
+  DECLARE_SCHEME_CALLBACK(unfolded_music_length, (SCM));
+  DECLARE_SCHEME_CALLBACK(volta_music_length, (SCM));
+  DECLARE_SCHEME_CALLBACK(folded_music_length, (SCM));    
   
-  virtual void do_print () const;
+  /// Transpose, with the interval central C to #p#
   virtual void transpose (Musical_pitch p);
-  virtual Moment duration () const;
-  virtual Musical_pitch to_relative_octave (Musical_pitch p);
+
+  /// Scale the music in time by #factor#.
+  virtual void compress (Moment factor);
   VIRTUAL_COPY_CONS(Music);
+
+  Repeated_music (Music*, int , Music_sequence*);
+  Repeated_music (Repeated_music const&);
 };
 
-#endif /* REPEATED_MUSIC_HH */
 
+#endif /* RepEATED_MUSIC_HH */