2 beam-engraver.cc -- implement Beam_engraver
4 source file of the GNU LilyPond music typesetter
6 (c) 1998--2002 Han-Wen Nienhuys <hanwen@cs.uu.nl>
9 #include "engraver-group-engraver.hh"
10 #include "engraver.hh"
11 #include "musical-request.hh"
16 #include "score-engraver.hh"
18 #include "drul-array.hh"
22 class Beam_engraver : public Engraver
25 Drul_array<Span_req*> reqs_drul_;
27 Spanner *finished_beam_p_;
29 Span_req * prev_start_req_;
31 Beaming_info_list * beam_info_p_;
32 Beaming_info_list * finished_beam_info_p_;
34 /// location within measure where beam started.
35 Moment beam_start_location_;
37 /// moment (global time) where beam started.
38 Moment beam_start_mom_;
40 bool subdivide_beams_;
43 void set_melisma (bool);
45 Moment last_stem_added_at_;
49 virtual void stop_translation_timestep ();
50 virtual void start_translation_timestep ();
51 virtual void finalize ();
53 virtual void acknowledge_grob (Grob_info);
54 virtual bool try_music (Music*);
55 virtual void process_music ();
57 virtual bool valid_start_moment();
58 virtual bool valid_end_moment ();
61 TRANSLATOR_DECLARATIONS( Beam_engraver );
66 Hmm. this isn't necessary, since grace beams and normal beams are
70 Beam_engraver::valid_start_moment()
72 Moment n = now_mom ();
74 return n.grace_part_ == Rational (0);
78 Beam_engraver::valid_end_moment()
80 return last_stem_added_at_.grace_part_ == Rational(0);
84 Beam_engraver::Beam_engraver ()
88 finished_beam_info_p_=0;
90 reqs_drul_[LEFT] = reqs_drul_[RIGHT] =0;
96 Beam_engraver::try_music (Music *m)
98 if (Span_req * c = dynamic_cast<Span_req*> (m))
100 if (scm_equal_p (c->get_mus_property ("span-type"),
101 ly_str02scm ("abort")) == SCM_BOOL_T)
103 reqs_drul_[START] = 0;
104 reqs_drul_[STOP] = 0;
109 else if (scm_equal_p (c->get_mus_property ("span-type"),
110 ly_str02scm ("beam")) == SCM_BOOL_T)
112 Direction d =c->get_span_dir ();
115 if (d == STOP && !valid_end_moment())
118 if (d == START && !valid_start_moment ())
123 SCM m = get_property ("automaticMelismata");
124 SCM b = get_property ("autoBeaming");
125 if (to_boolean (m) && !to_boolean (b))
139 Beam_engraver::set_melisma (bool m)
141 daddy_trans_l_->set_property ("beamMelismaBusy", m ? SCM_BOOL_T :SCM_BOOL_F);
145 Beam_engraver::process_music ()
147 if (reqs_drul_[STOP])
150 finished_beam_p_ = beam_p_;
151 finished_beam_info_p_ = beam_info_p_;
160 top_engraver ()->forbid_breaks ();
162 if (reqs_drul_[START])
166 reqs_drul_[START]->origin ()->warning (_ ("already have a beam"));
170 prev_start_req_ = reqs_drul_[START];
171 beam_p_ = new Spanner (get_property ("Beam"));
172 SCM smp = get_property ("measurePosition");
173 Moment mp = (unsmob_moment (smp)) ? *unsmob_moment (smp) : Moment (0);
175 beam_start_location_ = mp;
176 beam_start_mom_ = now_mom ();
178 beam_info_p_ = new Beaming_info_list;
180 /* urg, must copy to Auto_beam_engraver too */
182 announce_grob(beam_p_, reqs_drul_[START]->self_scm());
189 Beam_engraver::typeset_beam ()
191 if (finished_beam_p_)
193 finished_beam_info_p_->beamify(*unsmob_moment (get_property ("beatLength")),
196 Beam::set_beaming (finished_beam_p_, finished_beam_info_p_);
197 typeset_grob (finished_beam_p_);
198 delete finished_beam_info_p_;
199 finished_beam_info_p_ =0;
200 finished_beam_p_ = 0;
205 Beam_engraver::start_translation_timestep ()
207 reqs_drul_ [START] =0;
208 reqs_drul_[STOP] = 0;
212 SCM m = get_property ("automaticMelismata");
213 SCM b = get_property ("autoBeaming");
214 if (to_boolean (m) && !to_boolean (b))
218 subdivide_beams_ = to_boolean(get_property("subdivideBeams"));
223 Beam_engraver::stop_translation_timestep ()
229 Beam_engraver::finalize ()
234 prev_start_req_->origin ()->warning (_ ("unterminated beam"));
237 we don't typeset it, (we used to, but it was commented
238 out. Reason unknown) */
245 Beam_engraver::acknowledge_grob (Grob_info info)
249 if (Rest::has_interface (info.grob_l_))
251 info.grob_l_->add_offset_callback (Beam::rest_collision_callback_proc, Y_AXIS);
253 else if (Stem::has_interface (info.grob_l_))
255 Moment now = now_mom();
257 if (!valid_start_moment ())
260 Item *stem_l = dynamic_cast<Item*> (info.grob_l_);
261 if (Stem::beam_l (stem_l))
264 Rhythmic_req *rhythmic_req = dynamic_cast <Rhythmic_req *> (info.music_cause ());
267 String s = _ ("stem must have Rhythmic structure");
268 if (info.music_cause ())
269 info.music_cause ()->origin ()->warning (s);
277 last_stem_added_at_ = now;
278 int durlog = unsmob_duration (rhythmic_req->get_mus_property ("duration"))-> duration_log ();
281 rhythmic_req->origin ()->warning (_ ("stem doesn't fit in beam"));
282 prev_start_req_->origin ()->warning (_ ("beam was started here"));
286 [r4 c8] can just as well be modern notation.
290 stem_l->set_grob_property ("duration-log",
291 gh_int2scm (durlog));
292 Moment stem_location = now - beam_start_mom_ + beam_start_location_;
293 beam_info_p_->add_stem (stem_location,
295 Beam::add_stem (beam_p_, stem_l);
304 ENTER_DESCRIPTION(Beam_engraver,
305 /* descr */ "Handles Beam_requests by engraving Beams. If omitted, then notes will be
306 printed with flags instead of beams.",
308 /* acks */ "stem-interface rest-interface",
309 /* reads */ "beamMelismaBusy subdivideBeams",
313 class Grace_beam_engraver : public Beam_engraver
316 TRANSLATOR_DECLARATIONS(Grace_beam_engraver);
319 virtual bool valid_start_moment();
320 virtual bool valid_end_moment ();
323 Grace_beam_engraver::Grace_beam_engraver()
328 Grace_beam_engraver::valid_start_moment()
330 Moment n = now_mom ();
332 return n.grace_part_ != Rational (0);
337 Grace_beam_engraver::valid_end_moment ()
339 return beam_p_ && last_stem_added_at_.grace_part_ != Rational(0);
344 ENTER_DESCRIPTION(Grace_beam_engraver,
345 /* descr */ "Handles Beam_requests by engraving Beams. If omitted, then notes will
346 be printed with flags instead of beams. Only engraves beams when we
347 are at grace points in time.
350 /* acks */ "stem-interface rest-interface",
351 /* reads */ "beamMelismaBusy subdivideBeams",