X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=lily%2Finclude%2Fmusic-iterator.hh;h=86b3bf379a0127d8dd1b300e9b608f1e2971dc15;hb=5b4b0d6e9a197e8f9eb085b7c2ad78b8be3e5cfc;hp=636fc659c9111a3d87a8eba96d9638b1462320e2;hpb=1a66290a98e7de8d6d41485b5b71a9f7e1fe35c7;p=lilypond.git

diff --git a/lily/include/music-iterator.hh b/lily/include/music-iterator.hh
index 636fc659c9..86b3bf379a 100644
--- a/lily/include/music-iterator.hh
+++ b/lily/include/music-iterator.hh
@@ -1,101 +1,107 @@
 /*
-  music-iterator.hh -- declare {Music,Chord,Voice}_iterator
+  music-iterator.hh -- declare Music_iterator
 
   source file of the GNU LilyPond music typesetter
 
-  (c) 1997 Han-Wen Nienhuys <hanwen@stack.nl>
+  (c) 1997--2008 Han-Wen Nienhuys <hanwen@xs4all.nl>
 */
 
-
 #ifndef MUSIC_ITERATOR_HH
 #define MUSIC_ITERATOR_HH
 
-#include "lily-proto.hh"
-#include "plist.hh"
-#include "varray.hh"
+#include "std-vector.hh"
 #include "moment.hh"
+#include "virtual-methods.hh"
+#include "context-handle.hh"
 
-class Music_iterator {
-   Array<Translator *>report_to_l_arr_;
-   void push_translator (Translator*);
-    void pop_translator();
-protected:
-    bool first_b_;
-    virtual void do_print()const;
-    
-    virtual Translator * get_req_translator_l();
-    Music_iterator* get_iterator_p (Music*)const;
-    void set_translator (Translator*);
-    Music_iterator *daddy_iter_l_;
-    
-public:
-    Translator *report_to_l()const;
-    DECLARE_MY_RUNTIME_TYPEINFO;
- 
-    static Music_iterator* static_get_iterator_p (Music*,Translator*);
-    Music_iterator();
-    
-    virtual void process_and_next (Moment until);
-    virtual Moment next_moment()const;
-    virtual bool ok()const;
-    virtual ~Music_iterator();
-    virtual void construct_children();
-    void print()const;
-};
+/**
+   ---
+
+   Music_iterator is an object type that traverses the Music structure and
+   reports the events it finds to interpretation contexts. It is not yet
+   user-serviceable.
+
+
+   ---
+
+   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.
 
+   * Typically this reports the music to an interpretation context,
+   thus changing the state of the interpretation context.
 
-class Chord_iterator : public Music_iterator
+
+   TODO:
+
+   merge pending_moment and process?
+*/
+class Music_iterator
 {
-    const Chord *chord_C_;
-    Pointer_list<Music_iterator*> children_p_list_;
-public:
-    ~Chord_iterator();
-    Chord_iterator (Chord const*);
-    DECLARE_MY_RUNTIME_TYPEINFO;
 protected:
-    virtual void do_print()const;
-    virtual void construct_children();
-    virtual void process_and_next (Moment);
-    virtual Moment next_moment()const;
-    virtual bool ok()const;
-};
+  Moment music_length_;
+  Moment start_mom_;
+
+  DECLARE_CLASSNAME(Music_iterator);
+  DECLARE_SMOBS (Music_iterator);
+  Music_iterator (Music_iterator const &);
 
-class Request_chord_iterator : public Music_iterator {
-    const Request_chord * elt_l_;
-    Moment elt_duration_;
-    bool last_b_;
 public:
-    Request_chord_iterator (Request_chord*);
-    DECLARE_MY_RUNTIME_TYPEINFO;
+  Moment music_get_length () const;
+  Moment music_start_mom () const;
+  Music_iterator ();
+  void report_event (Music *);
+  Context *get_outlet () const;
+  void set_context (Context *);
+  static SCM get_static_get_iterator (Music *mus);
+  void init_context (Music *, Context *);
+  void quit ();
+  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 void process (Moment until);
+  virtual void derived_mark () const;
+  virtual void construct_children ();
+  DECLARE_SCHEME_CALLBACK (constructor, ());
+  SCM get_iterator (Music *) const;
 
+  Music *get_music () const;
 protected:
-    virtual void process_and_next (Moment);
-    virtual Moment next_moment()const;
-    virtual void construct_children();
-    virtual bool ok()const;
-    virtual void do_print()const;
+  virtual void do_quit ();
+  void descend_to_child (Context *);
+
+private:
+  Context_handle handle_;
+  Music *music_;
 };
 
+bool is_child_context (Context *me, Context *child);
 
-class Voice_iterator :  private PCursor<Music*>, public Music_iterator
-{
-    Moment here_mom_;
-    const Voice * voice_C_;
-    Music_iterator * iter_p_;
-    void start_next_element();
-    void leave_element();
-    void set_voice_translator();
-    
-public:
-    Voice_iterator (Voice const*);
-    DECLARE_MY_RUNTIME_TYPEINFO;
-protected:
-    virtual void do_print()const;
-    virtual void construct_children();
-    ~Voice_iterator();    
-    virtual void process_and_next (Moment);
-    virtual Moment next_moment()const;
-    virtual bool ok()const;
-};
+#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