lily/include/engraver.hh

   1 /*
   2   engraver.hh -- declare Engraver
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1996,  1997--1998 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   7 */
   8
   9
  10 #ifndef ENGRAVER_HH
  11 #define ENGRAVER_HH
  12
  13 #include "lily-proto.hh"
  14 #include "array.hh"
  15 #include "request.hh"
  16 #include "score-element-info.hh"
  17 #include "staff-info.hh"
  18 #include "translator.hh"
  19
  20
  21 /**
  22   a struct which processes requests, and creates the #Score_element#s.
  23   It may use derived classes. Hungarian postfix: grav
  24
  25   */
  26 class Engraver : public virtual Translator {
  27
  28   friend class Engraver_group_engraver;
  29
  30 protected:
  31
  32
  33   /// utility
  34   Paper_def * paper() const;
  35   /**
  36     Invoke walker method to typeset element. Default: pass on to daddy.
  37     */
  38   virtual void typeset_element (Score_element*elem_p);
  39
  40   /**
  41     take note of item/spanner
  42     put item in spanner. Adjust local key; etc.
  43
  44     Default: ignore the info
  45     */
  46   virtual void acknowledge_element (Score_element_info) {}
  47
  48   /** Do things with stuff found in acknowledge_element. Ugh. Should
  49      be looped with acknowledge_element.
  50
  51    */
  52   virtual void process_acknowledged () {}
  53   /**
  54     Announce element. Default: pass on to daddy. Utility
  55     */
  56   virtual void announce_element (Score_element_info);
  57
  58   /**
  59     Get information on the staff. Default: ask daddy.
  60     */
  61   virtual Staff_info get_staff_info() const;
  62   virtual void fill_staff_info (Staff_info&);
  63
  64 public:
  65   TRANSLATOR_CLONE(Engraver);
  66   Engraver_group_engraver * daddy_grav_l() const;
  67   /**
  68     override other ctor
  69    */
  70   Engraver () {}
  71
  72   DECLARE_MY_RUNTIME_TYPEINFO;
  73   virtual Engraver * access_Engraver () { return this; }
  74 };
  75
  76
  77 #endif // ENGRAVER_HH
  78