X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Finclude%2Fmusic-iterator.hh;h=86b3bf379a0127d8dd1b300e9b608f1e2971dc15;hb=5b4b0d6e9a197e8f9eb085b7c2ad78b8be3e5cfc;hp=cc5da19c392e719e954e5333202d900e6d985b6e;hpb=5d1ddaf889233f8e5c32a118f9e843e1becca2d2;p=lilypond.git diff --git a/lily/include/music-iterator.hh b/lily/include/music-iterator.hh index cc5da19c39..86b3bf379a 100644 --- a/lily/include/music-iterator.hh +++ b/lily/include/music-iterator.hh @@ -3,17 +3,16 @@ source file of the GNU LilyPond music typesetter - (c) 1997--2005 Han-Wen Nienhuys + (c) 1997--2008 Han-Wen Nienhuys */ - #ifndef MUSIC_ITERATOR_HH #define MUSIC_ITERATOR_HH -#include "array.hh" +#include "std-vector.hh" #include "moment.hh" #include "virtual-methods.hh" -#include "interpretation-context-handle.hh" +#include "context-handle.hh" /** --- @@ -24,30 +23,29 @@ --- - - Conceptually a music-iterator operates on a queue of musical events - that are pending. This queue does not actually exist, but it is a - way of viewing and traversing music-expressions. - - ok () -- events left ? + Conceptually a music-iterator operates on a queue of musical events + that are pending. This queue does not actually exist, but it is a + way of viewing and traversing music-expressions. + + + ok () -- events left ? - pending_mom () -- time tag of the next event to be processed. - PRECONDITION: this->ok () holds. - - process (M) -- process all at M (Precondition: no events exist - before M, this->ok () holds). Side-effects: - - * This removes all events at M from the pending queue. + pending_mom () -- time tag of the next event to be processed. + PRECONDITION: this->ok () holds. - * Typically this reports the music to an interpretation context, - thus changing the state of the interpretation context. + process (M) -- process all at M (Precondition: no events exist + before M, this->ok () holds). Side-effects: + * This removes all events at M from the pending queue. - TODO: + * Typically this reports the music to an interpretation context, + thus changing the state of the interpretation context. - merge pending_moment and process? - + + TODO: + + merge pending_moment and process? */ class Music_iterator { @@ -55,79 +53,55 @@ protected: Moment music_length_; Moment start_mom_; - DECLARE_SMOBS (Music_iterator, dummy); - Music_iterator (Music_iterator const&); + DECLARE_CLASSNAME(Music_iterator); + DECLARE_SMOBS (Music_iterator); + Music_iterator (Music_iterator const &); + public: - Moment music_get_length () const; Moment music_start_mom () const; Music_iterator (); - - /** - Do the reporting. Will try MUSIC_L_ in its own translator first, - then its children. Returns the iterator that succeeded - */ - Music_iterator * try_music (Music *) const; - - /** - The translation unit that we this iterator is reporting to now. - */ - Context * get_outlet () const; - + void report_event (Music *); + Context *get_outlet () const; void set_context (Context *); - - /** Get an iterator matching the type of MUS, and use TRANS to find - an accompanying translation unit - */ - static SCM get_static_get_iterator (Music * mus); - void init_translator (Music *, Context *); + static SCM get_static_get_iterator (Music *mus); + void init_context (Music *, Context *); void quit (); - void substitute_outlet (Context * from, Context *to); + void substitute_outlet (Context *from, Context *to); + void descend_to_bottom_context (); virtual void derived_substitute (Context *, Context *); virtual Moment pending_moment () const; virtual bool ok () const; - - virtual bool run_always () const; + virtual bool run_always () const; virtual void process (Moment until); virtual void derived_mark () const; virtual void construct_children (); - - /** - Construct sub-iterators, and set the translator to - report to. - */ - - DECLARE_SCHEME_CALLBACK(constructor, ()); - - /** - Get an iterator for MUS, inheriting the translation unit from THIS. - */ + DECLARE_SCHEME_CALLBACK (constructor, ()); SCM get_iterator (Music *) const; - virtual Music_iterator* try_music_in_children (Music *) const; - - Music * get_music () const; + Music *get_music () const; protected: - virtual void do_quit(); - void descend_to_child (Context*); + virtual void do_quit (); + void descend_to_child (Context *); + private: - Interpretation_context_handle handle_; - Music * music_; + Context_handle handle_; + Music *music_; }; bool is_child_context (Context *me, Context *child); -#define IMPLEMENT_CTOR_CALLBACK(Class) \ -LY_DEFINE_MEMBER_FUNCTION(Class, constructor, #Class "::constructor", \ - 0, 0, 0, \ - (), \ - "")\ -{ \ - SCM val = (new Class)->self_scm(); \ - scm_gc_unprotect_object (val);\ - return val ; \ -} \ - -DECLARE_UNSMOB(Music_iterator, iterator); +#define IMPLEMENT_CTOR_CALLBACK(Class) \ + LY_DEFINE_MEMBER_FUNCTION (Class, constructor, \ + mangle_cxx_identifier (string (#Class) + "::constructor").c_str(), \ + 0, 0, 0, \ + (), \ + "") \ + { \ + Class *c = (new Class); \ + return c->unprotect (); \ + } + +DECLARE_UNSMOB (Music_iterator, iterator); #endif // MUSIC_ITERATOR_HH