/*
  engraver.hh -- declare Engraver

  source file of the GNU LilyPond music typesetter

  (c) 1996, 1997 Han-Wen Nienhuys <hanwen@stack.nl>
*/


#ifndef ENGRAVER_HH
#define ENGRAVER_HH

#include "lily-proto.hh"
#include "varray.hh"
#include "request.hh"
#include "score-elem-info.hh"
#include "staff-info.hh"
#include "translator.hh"


/**
  a struct which processes requests, and creates the #Score_elem#s.
  It may use derived classes. Hungarian postfix: grav
  
  */
class Engraver : public virtual Translator {
    
  friend class Engraver_group_engraver;

protected:
    

  /// utility
  Paper_def * paper() const;
  /**
    Invoke walker method to typeset element. Default: pass on to daddy.
    */
  virtual void typeset_element (Score_elem*elem_p);
    
  /**
    take note of item/spanner
    put item in spanner. Adjust local key; etc.

    Default: ignore the info
    */
  virtual void acknowledge_element (Score_elem_info) {}
  /**
    Announce element. Default: pass on to daddy. Utility
    */
  virtual void announce_element (Score_elem_info);
   
  /**
    Get information on the staff. Default: ask daddy.
    */
  virtual Staff_info get_staff_info() const;
  virtual void fill_staff_info (Staff_info&);

public:
  TRANSLATOR_CLONE(Engraver);
  Engraver_group_engraver * daddy_grav_l() const;
  /**
    override other ctor
   */
  Engraver () {}

  DECLARE_MY_RUNTIME_TYPEINFO;
  void print() const;
  virtual Engraver * engraver_l () { return this; }
};


#endif // ENGRAVER_HH

