]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/include/score-element.hh
patch::: 1.3.86.jcn2
[lilypond.git] / lily / include / score-element.hh
index eaaaf1482bb48a54f99e75bf3ccf7be15d7c07be..b867d2119e2b5d5d53af55b19e0098bfb167ef63 100644 (file)
@@ -1,7 +1,7 @@
 /*
   score-element.hh -- declare Score_element
 
-  (c) 1996-1999 Han-Wen Nienhuys
+  (c) 1996-1999--2000 Han-Wen Nienhuys
 */
 
 #ifndef STAFFELEM_HH
@@ -9,38 +9,60 @@
 
 #include "parray.hh"
 #include "virtual-methods.hh"
-#include "directed-graph.hh"
-#include "graphical-element.hh"
-#include "protected-scm.hh"
 #include "lily-guile.hh"
+#include "lily-proto.hh"
+#include "smobs.hh"
+#include "dimension-cache.hh"
 
+typedef Interval (*Extent_callback)(Score_element *,Axis);
+typedef Real (*Offset_callback)(Score_element *,Axis);
 
-typedef void (Score_element::*Score_element_method_pointer) (void);
 
-/** Both Spanner and Item are Score_element's. Most Score_element's depend
-  on other Score_element's, eg, Beam needs to know and set direction of
-  Stem. So the Beam has to be calculated *before* Stem. This is
-  accomplished with the dependencies fields of struct Score_element,
-  which are implemented in the Directed_graph_node class: all elements
-  form an acyclic graph.
 
-  (elem)
+/**
+    for administration of what was done already
+    */
+enum Score_element_status {
+  ORPHAN=0,                    // not yet added to pstaff
+  VIRGIN,                      // added to pstaff
+  PRECALCING,
+  PRECALCED,           // calcs before spacing done
+  POSTCALCING,         // busy calculating. This is used to trap cyclic deps.
+  POSTCALCED,          // after spacing calcs done
+  BREWING,
+  BREWED,
+};
 
+typedef void (Score_element::*Score_element_method_pointer) (void);
 
-Element Properties:
+/**
+   Basic output object.
 
-Boolean (true iff defined)
+    Element Properties:
 
break_helper_only -- if defined try to junk this after calcing breakpoints.
  transparent -- boolean: if true, do not print anything black.
 
- transparent -- do not calc. output
+   dependencies -- list of score-element pointers that indicate who to
+   compute first.
 
+   interfaces -- list of symbols indicating the interfaces supported
+   by this object.
+
+   extra-offset -- pair of reals (a cons) forcing an extra offset
+   before outputting
+
+   glyph -- afm character name to output.
+   
 */
-class Score_element : public virtual Graphical_element {
-  Protected_scm element_property_alist_;
-  Link_array<Score_element> dependency_arr_;
+class Score_element  {
+  /**
+     The lookup, determined by the font size. Cache this value.
+   */
   Lookup * lookup_l_;
+
 public:
+  SCM immutable_property_alist_;
+  SCM mutable_property_alist_;
   Score_element *original_l_;
 
   /**
@@ -48,23 +70,32 @@ public:
     Score_element::calcalute_dependencies ()
 
     0 means ORPHAN,
-    -1 means deleted
-    
    */
-  int status_i_;
+  char status_i_;
+  String name () const;
 
+  /*
+    IDEA: make this a global variable. This is the same for all
+    elements, I think it is safe to assume that we will not have
+    scores being formatted multithreadedly.
+   */
   Paper_score *pscore_l_;
-  Molecule * output_p_;
-  Score_element ();
+
+  Score_element (SCM basic_props);
   Score_element (Score_element const&);
-  virtual void print () const;
 
   /*
     properties
    */
-  SCM get_elt_property (SCM sym) const;
-  void set_elt_property (SCM sym, SCM val);
-  SCM remove_elt_property (SCM key);
+  SCM get_elt_property (const char*) const;
+  SCM get_elt_property (SCM) const;
+  void set_elt_property (const char * , SCM val);
+  void set_immutable_elt_property (const char * , SCM val);
+  void set_immutable_elt_property (SCM key, SCM val);  
+  void set_elt_property (SCM , SCM val);  
+  void set_elt_pointer (const char*, SCM val);
+  friend class Property_engraver; //  UGHUGHUGH.
+  SCM remove_elt_property (const char* nm);
 
   /*
     related classes.
@@ -72,56 +103,111 @@ public:
   Paper_def *paper_l () const;
   Lookup const *lookup_l () const;
 
-  virtual ~Score_element ();
   void add_processing ();
 
-  void substitute_dependency (Score_element*,Score_element*);
-  void remove_dependency (Score_element*);
   /**
     add a dependency. It may be the 0 pointer, in which case, it is ignored.
     */
   void add_dependency (Score_element*);    
   virtual Line_of_score * line_l () const;
   bool linked_b () const;
+
+
   VIRTUAL_COPY_CONS(Score_element);
  
-  // ugh: no protection. Denk na, Vrij Veilig
-  void calculate_dependencies (int final, int busy, Score_element_method_pointer funcptr);
+  /**
+     Recursively track all dependencies of this Score_element.  The
+     status_i_ field is used as a mark-field.  It is marked with
+     #busy# during execution of this function, and marked with #final#
+     when finished.
 
-protected:
-  Score_element* dependency (int) const;
-  int dependency_size () const;
+     #funcptr# is the function to call to update this element.
+   */
+  void calculate_dependencies (int final, int busy, SCM funcname);
+
+
+  static SCM handle_broken_smobs (SCM, SCM criterion);
+
+  virtual void do_break_processing ();
+  virtual Score_element *find_broken_piece (Line_of_score*) const;
+  virtual void discretionary_processing ();
+  virtual SCM do_derived_mark ();
+
+  Molecule get_molecule () const;
+  void suicide ();
   
-  virtual void output_processing ();
-  virtual Interval do_height () const;
-  virtual Interval do_width () const;
-    
-  /// do printing of derived info.
-  virtual void do_print () const;
-  /// generate the molecule    
-  virtual Molecule* do_brew_molecule_p () const;
+  static Interval preset_extent (Score_element *,Axis);
+  static Interval point_dimension_callback (Score_element *,Axis );
+  static Interval molecule_extent (Score_element *,Axis);
+
+protected:
   ///executed directly after the item is added to the Paper_score
   virtual void do_add_processing ();
-  /// do calculations before determining horizontal spacing
-  virtual void do_pre_processing ();
+  static Interval dim_cache_callback (Dimension_cache const*);
+  
+public:
+  static SCM ly_set_elt_property (SCM, SCM,SCM);
+  static SCM ly_get_elt_property (SCM, SCM);  
 
-  /// generate rods & springs
-  virtual void do_space_processing ();
+  bool has_interface (SCM intf);
+  void set_interface (SCM intf);
 
-  virtual void do_breakable_col_processing ();
-  /// do calculations after determining horizontal spacing
-  virtual void do_post_processing ();
-    
-  virtual void do_substitute_element_pointer (Score_element * , Score_element *);
-  virtual void do_break_processing ();
+
+  static SCM brew_molecule (SCM);
   virtual void handle_broken_dependencies ();
   virtual void handle_prebroken_dependencies ();
-  virtual void handle_prebroken_dependents ();
-  virtual Link_array<Score_element> get_extra_dependencies () const;
 
-  static Interval dim_cache_callback (Dimension_cache*);
+
+  DECLARE_SMOBS(Score_element,foo);
+
+  void init ();
+
+  Dimension_cache dim_cache_[NO_AXES];
+
+public:
+  bool empty_b (Axis a) const;
+  Interval extent (Axis) const;
+  /**
+    translate in one direction
+    */
+    
+  void translate_axis (Real, Axis);
+
+  /**
+     Find the offset relative to D.  If   D equals THIS, then it is 0.
+     Otherwise, it recursively defd as
+
+     OFFSET_ + PARENT_L_->relative_coordinate (D)
+   */
+  Real relative_coordinate (Score_element const* refp, Axis) const;
+  /**
+    Find the group-element which has both #this# and #s#
+   */
+  Score_element*common_refpoint (Score_element const* s, Axis a) const;
+  Score_element*common_refpoint (SCM elt_list, Axis a) const;
+
+  // duh. slim down interface here. (todo)
+  bool has_offset_callback_b (Offset_callback, Axis)const;
+  void add_offset_callback (Offset_callback, Axis);
+  bool has_extent_callback_b (Extent_callback, Axis)const;  
+  bool has_extent_callback_b (Axis) const;
+  void set_extent_callback (Extent_callback , Axis);
+
+  /**
+    Invoke callbacks to get offset relative to parent.
+   */
+  Real get_offset (Axis a) const;
+  /**
+     Set the  parent refpoint of THIS to E
+   */
+  void set_parent (Score_element* e, Axis);
+  
+  Score_element *parent_l (Axis a) const;
+  static SCM fixup_refpoint (SCM);
 };
 
+Score_element * unsmob_element (SCM);
 
 #endif // STAFFELEM_HH