lily/include/engraver.hh

   1 /*
   2   engraver.hh -- declare Engraver
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1996--2000 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 "translator.hh"
  18
  19
  20 /**
  21   a struct which processes requests, and creates the #Score_element#s.
  22   It may use derived classes.
  23   */
  24 class Engraver : public virtual Translator {
  25
  26   friend class Engraver_group_engraver;
  27 protected:
  28   /// utility
  29   Paper_def * paper_l() const;
  30
  31   /*
  32     Call this last thing.
  33    */
  34   virtual void typeset_element (Score_element*elem_p);
  35   /*
  36     take note of item/spanner
  37     put item in spanner. Adjust local key; etc.
  38
  39     Default: ignore the info
  40     */
  41   virtual void acknowledge_element (Score_element_info) {}
  42
  43   /** Do things with stuff found in acknowledge_element. Ugh. Should
  44      be looped with acknowledge_element.
  45
  46    */
  47   virtual void process_acknowledged () {}
  48   /**
  49     Announce element. Default: pass on to daddy. Utility
  50     */
  51   virtual void announce_element (Score_element*, Music*);
  52   virtual void announce_element (Score_element_info);
  53 public:
  54   VIRTUAL_COPY_CONS(Translator);
  55   Engraver_group_engraver * daddy_grav_l() const;
  56   /**
  57     override other ctor
  58    */
  59   Engraver () {}
  60 };
  61
  62
  63 #endif // ENGRAVER_HH
  64