]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/include/beam.hh
release: 1.3.90
[lilypond.git] / lily / include / beam.hh
index de68f6f99ca4936d8d0597da61756bf1e68e22ad..3ed32fae68a1cdd4928890ba64e511ecd93649b9 100644 (file)
@@ -1,91 +1,92 @@
 /*
   beam.hh -- part of GNU LilyPond
 
-  (c) 1996--1999 Han-Wen Nienhuys
+  (c) 1996--2000 Han-Wen Nienhuys
 */
 
 #ifndef BEAM_HH
 #define BEAM_HH
 
 #include "lily-proto.hh"
-#include "directional-spanner.hh"
-#include "stem-info.hh"
+#include "lily-guile.hh"
 
 
 /** a beam connects multiple stems.
 
   Beam adjusts the stems its owns to make sure that they reach the
-  beam and that point in the correct direction
+  beam and that point in the correct direction (urg?)
 
-elt property:
+   elt_properties:
+   
+   y-position -- real  (position of left edge)
 
-damping: amount of beam slope damping. (int)
+   height -- real  (dy)
 
-should beam slope be damped? 0: no, 1: yes, 100000: horizontal beams 
 
-slope_quantisation: 'none, 'normal or 'traditional
+   Read-only
+   =========
+   
+   flag-width-function --
 
+   damping -- amount of beam slope damping. (int)
+     should beam slope be damped? 0: no, 1: yes, 100000: horizontal beams 
+
+   default-neutral-direction -- which direction to choose if we're in
+     the middle of the staff
+   
+   thickness -- weight of beams, in staffspace
+
+   space-function -- function of type multiplicity -> real (in staffspace)
+
+   beamed-stem-shorten --
+
+   height-quants --
+
+   vertical-position-quant-function --
+
+   dir-function --
+   
+   damping -- damping factor (real).
+
+   outer-stem-length-limit -- catch suspect beam slopes, set slope to zero if
+     outer stem is lengthened more than this (in staffspace)
+
+   slope-limit -- set slope to zero if slope is running away steeper than this.
 */
-class Beam : public Directional_spanner  {
+class Beam
+{
 public:
-  /** 
-    The beams should be prevented to conflict with the stafflines, 
-    especially at small slopes.
-    */
-  enum Quantisation { NONE, NORMAL, TRADITIONAL };
-  enum Dir_algorithm { /* DOWN=-1, UP=1, */ MAJORITY=2, MEAN, MEDIAN };
-
-  Link_array<Stem> stems_;
-  /**
-     the slope of the beam in (staffpositions) per (X-dimension, in PT).
-     UGH. standardise this for once and for all.
-   */
-  Real slope_f_;
-
-  /// position of leftmost end of beam  
-  Real left_y_;
-
-
-  /// maximum number of beams (for opening-up of beam-spacing)
-  int multiple_i_;
-
-  Array<Stem_info> sinfo_;
-  
-  Beam();
-  void add_stem (Stem*);
-  Stem_info get_stem_info (Stem*);
-
-  void set_grouping (Rhythmic_grouping def, Rhythmic_grouping current);
-  void set_beaming (Beaming_info_list *);
-  void set_stemlens ();
-  VIRTUAL_COPY_CONS(Score_element);
-
-protected:
-  virtual Interval do_width () const;    
-  Offset center () const;
-  Direction get_default_dir () const;
-  void set_direction (Direction);
-  void set_steminfo ();
-  bool auto_knee (SCM gap, bool interstaff_b);
-  bool auto_knees ();
-  
-  virtual void do_pre_processing ();
-  virtual void do_post_processing ();
-  virtual void do_substitute_element_pointer (Score_element*, Score_element*);
-  virtual void do_add_processing ();
-  virtual void do_print() const;
-  virtual Molecule*do_brew_molecule_p () const;
-
-  Molecule stem_beams (Stem *here, Stem *next, Stem *prev) const;
+  static int visible_stem_count (Score_element*);
+  static  Item* first_visible_stem (Score_element*);
+  static  Item* last_visible_stem (Score_element*);
+  static bool has_interface (Score_element*);
+  static void set_interface (Score_element*);  
+  static Real rest_collision_callback (Score_element *,Axis);
+  Beam (SCM);
+  static void add_stem (Score_element*,Score_element*);
+  static void set_beaming (Score_element*,Beaming_info_list *);
+  static void set_stemlens (Score_element*);
+  static int get_multiplicity (Score_element*me);
+  static SCM brew_molecule (SCM);
+  static SCM before_line_breaking (SCM);
+  static SCM after_line_breaking (SCM);
+  static Molecule stem_beams (Score_element*,Item *here, Item *next, Item *prev);
 
 private:
-  void calculate_slope ();
-  Real check_stemlengths_f (bool set_b);
-  void solve_slope ();
-
-  void quantise_left_y (bool extend_b);
-  void quantise_dy ();
-
+  static Direction get_default_dir (Score_element*);
+  static  void set_stem_directions (Score_element*);
+  static  void auto_knees (Score_element*);
+  static  bool auto_knee (Score_element*,String gap_str, bool interstaff_b);
+  static void set_stem_shorten (Score_element*);
+  static  void calc_default_position_and_height (Score_element*,Real* y, Real* dy);
+  static  bool suspect_slope_b (Score_element*, Real y, Real dy);
+  static  Real calc_slope_damping_f (Score_element*, Real dy);
+  static  Real calc_stem_y_f (Score_element*, Item* s, Real y, Real dy);
+  static  Real check_stem_length_f (Score_element*, Real y, Real dy);
+  static  void set_stem_length (Score_element*, Real y, Real dy);
+  static   Real quantise_dy_f (Score_element*, Real dy);
+  static  Real quantise_y_f (Score_element*, Real y, Real dy, int quant_dir);
+  static int forced_stem_count (Score_element*);
 };
 
 #endif // BEAM_HH