/*
- beam.hh -- part of GNU LilyPond
+ This file is part of LilyPond, the GNU music typesetter.
- (c) 1996--2000 Han-Wen Nienhuys
+ Copyright (C) 1996--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
+ Jan Nieuwenhuizen <janneke@gnu.org>
+
+ LilyPond is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ LilyPond is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef BEAM_HH
#define BEAM_HH
+#include "grob-interface.hh"
+#include "std-vector.hh"
#include "lily-proto.hh"
-#include "spanner.hh"
+#include "stem-info.hh"
+
+struct Beam_segment
+{
+ int vertical_count_;
+ Interval horizontal_;
+ Beam_segment ();
+};
+
+bool beam_segment_less (Beam_segment const& a, Beam_segment const& b);
+struct Beam_stem_segment
+{
+ Beam_stem_segment ();
-/** a beam connects multiple stems.
+ Grob *stem_;
+ Real width_;
+ Real stem_x_;
+ int rank_;
+ vsize stem_index_;
+ bool gapped_;
+ Direction dir_;
+ int max_connect_;
+};
- Beam adjusts the stems its owns to make sure that they reach the
- beam and that point in the correct direction (urg?)
- elt_properties:
- y-position: real (position of left edge)
- height: real (dy)
+bool operator <(Beam_stem_segment const &a, Beam_stem_segment const &b);
- damping: amount of beam slope damping. (int)
- should beam slope be damped? 0: no, 1: yes, 100000: horizontal beams
-*/
-class Beam : public Spanner
+class Beam
{
public:
- static SCM brew_molecule (SCM);
+ static int normal_stem_count (Grob *);
+ static Grob *first_normal_stem (Grob *);
+ static Grob *last_normal_stem (Grob *);
+ DECLARE_GROB_INTERFACE();
+ static void add_stem (Grob *, Grob *);
+ static bool is_cross_staff (Grob *);
+ static bool is_knee (Grob *);
+ static void set_beaming (Grob *, Beaming_pattern const *);
+ static void set_stemlens (Grob *);
+ static int get_beam_count (Grob *me);
+ static Real get_beam_translation (Grob *me);
+ static Real get_beam_thickness (Grob *me);
+ static void connect_beams (Grob *me);
+ static vector<Beam_segment> get_beam_segments (Grob *me_grob, Grob **common);
+ static Interval no_visible_stem_positions (Grob *me, Interval default_value);
+ DECLARE_SCHEME_CALLBACK (rest_collision_callback, (SCM element, SCM prev_off));
+ DECLARE_SCHEME_CALLBACK (print, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_beaming, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_stem_shorten, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_direction, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_positions, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_least_squares_positions, (SCM, SCM));
+ DECLARE_SCHEME_CALLBACK (calc_normal_stems, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_concaveness, (SCM));
+ DECLARE_SCHEME_CALLBACK (set_stem_lengths, (SCM));
+ DECLARE_SCHEME_CALLBACK (calc_cross_staff, (SCM));
- int stem_count () const;
- Stem* stem (int) const;
- Stem* stem_top () const;
- int visible_stem_count () const;
- Stem* first_visible_stem () const;
- Stem* last_visible_stem () const;
- static Real rest_collision_callback (Score_element const*,Axis);
- Beam (SCM);
- void add_stem (Stem*);
- void set_grouping (Rhythmic_grouping def, Rhythmic_grouping current);
- void set_beaming (Beaming_info_list *);
- void set_stemlens ();
- VIRTUAL_COPY_CONS(Score_element);
-
- int get_multiplicity () const;
+ /* position callbacks */
+ DECLARE_SCHEME_CALLBACK (shift_region_to_valid, (SCM, SCM));
+ DECLARE_SCHEME_CALLBACK (slope_damping, (SCM, SCM));
+ DECLARE_SCHEME_CALLBACK (quanting, (SCM, SCM));
+
+ static int get_direction_beam_count (Grob *me, Direction d);
-public:
-
- SCM member_before_line_breaking ();
- static SCM before_line_breaking (SCM);
- SCM member_after_line_breaking ();
- static SCM after_line_breaking (SCM);
- SCM member_brew_molecule () const;
-
- Molecule stem_beams (Stem *here, Stem *next, Stem *prev) const;
private:
- Direction get_default_dir () const;
- void set_stem_directions ();
- void auto_knees ();
- bool auto_knee (String gap_str, bool interstaff_b);
- void set_stem_shorten ();
- void calc_default_position_and_height (Real* y, Real* dy) const;
- bool suspect_slope_b (Real y, Real dy) const;
- Real calc_slope_damping_f (Real dy) const;
- Real calc_stem_y_f (Stem* s, Real y, Real dy) const;
- Real check_stem_length_f (Real y, Real dy) const;
- void set_stem_length (Real y, Real dy);
- Real quantise_dy_f (Real dy) const;
- Real quantise_y_f (Real y, Real dy, int quant_dir);
- int forced_stem_count () const;
+ friend class Beam_scoring_problem;
+
+ static Direction get_default_dir (Grob *);
+ static void set_stem_directions (Grob *, Direction);
+ static void consider_auto_knees (Grob *);
+ static void set_stem_shorten (Grob *);
+ static int forced_stem_count (Grob *);
+ static Real calc_stem_y (Grob *, Grob *s, Grob **c,
+ Real, Real, Direction,
+ Drul_array<Real> pos, bool french);
};
-#endif // BEAM_HH
+
+#endif /* BEAM_HH */