lily/include/engraver.hh

   1 /*
   2   engraver.hh -- declare Engraver
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c)  1996--2003 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 "event.hh"
  16 #include "grob-info.hh"
  17 #include "translator.hh"
  18
  19
  20 /**
  21   a struct which processes events, and creates the #Grob#s.
  22   It may use derived classes.
  23   */
  24 class Engraver : public virtual Translator {
  25
  26   friend class Engraver_group_engraver;
  27 protected:
  28   /*
  29     Call this when you're finished with ELEM_P.
  30    */
  31   virtual void typeset_grob (Grob*elem);
  32   /*
  33     take note of item/spanner
  34     put item in spanner. Adjust local key; etc.
  35
  36     Default: ignore the info
  37     */
  38   virtual void acknowledge_grob (Grob_info) {}
  39
  40   /** Do things with stuff found in acknowledge_grob. Ugh. Should
  41      be looped with acknowledge_grob.
  42
  43    */
  44   virtual void process_acknowledged_grobs () {}
  45   /**
  46     Announce element. Default: pass on to daddy. Utility
  47     */
  48   virtual void announce_grob (Grob*, SCM cause);
  49   virtual void announce_grob (Grob_info);
  50   virtual void process_music ();
  51
  52   Score_engraver * top_engraver () const;
  53
  54   Item * internal_make_item (SCM);
  55   Spanner * internal_make_spanner (SCM);
  56
  57 public:
  58   Engraver_group_engraver * get_daddy_grav () const;
  59   /**
  60     override other ctor
  61    */
  62   TRANSLATOR_DECLARATIONS(Engraver);
  63 };
  64
  65 #define make_item(x) internal_make_item (ly_symbol2scm (x))
  66 #define make_spanner(x) internal_make_spanner (ly_symbol2scm (x))
  67
  68
  69
  70 #endif // ENGRAVER_HH
  71