-/*
+/*
repeated-music.hh -- declare Repeated_music
-
+
source file of the GNU LilyPond music typesetter
-
- (c) 1998 Jan Nieuwenhuizen <janneke@gnu.org>
-
- */
+
+ (c) 1999--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
+*/
#ifndef REPEATED_MUSIC_HH
#define REPEATED_MUSIC_HH
-#include "music-list.hh"
+#include "music.hh"
/**
- Repeats and voltas
- */
-class Repeated_music : public Music
+ 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:
- int repeats_i_;
- bool unfold_b_;
- Music* repeat_p_;
- Music_sequence* alternative_p_;
-
- Repeated_music (Music*, int n, Music_sequence*);
- Repeated_music (Repeated_music const& s);
- virtual ~Repeated_music ();
-
- virtual void do_print () const;
- virtual void transpose (Musical_pitch p);
- virtual Moment duration () const;
- virtual Musical_pitch to_relative_octave (Musical_pitch p);
- VIRTUAL_COPY_CONS(Music);
+ static Music *body (Music *);
+ static SCM alternatives (Music *);
+
+ /* How often do we repeat? */
+ static int repeat_count (Music *);
+ DECLARE_SCHEME_CALLBACK (relative_callback, (SCM, SCM));
+
+ static Moment body_get_length (Music *);
+ static Moment alternatives_get_length (Music *, bool fold);
+ static Moment alternatives_volta_get_length (Music *);
+
+ DECLARE_SCHEME_CALLBACK (unfolded_music_length, (SCM));
+ DECLARE_SCHEME_CALLBACK (volta_music_length, (SCM));
+ DECLARE_SCHEME_CALLBACK (folded_music_length, (SCM));
+ DECLARE_SCHEME_CALLBACK (minimum_start, (SCM));
+ DECLARE_SCHEME_CALLBACK (first_start, (SCM));
};
#endif /* REPEATED_MUSIC_HH */
-