2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 2005--2010 Han-Wen Nienhuys <hanwen@xs4all.nl>
7 LilyPond is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 LilyPond is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
21 #include "engraver.hh"
23 #include "align-interface.hh"
24 #include "axis-group-interface.hh"
26 #include "grob-array.hh"
28 #include "pointer-group-interface.hh"
30 #include "stream-event.hh"
31 #include "text-interface.hh"
33 #include "translator.icc"
38 Spanner *continuation_line_;
48 Stream_event *current_event_;
49 bool force_no_continuation_;
54 force_no_continuation_ = false;
55 continuation_line_ = 0;
57 alteration_ = SCM_EOL;
59 diminished_ = SCM_EOL;
60 augmented_slash_ = SCM_EOL;
65 /* Mark the members of the struct as used for the GUILE Garbage Collection */
68 scm_gc_mark (number_);
69 scm_gc_mark (alteration_);
70 scm_gc_mark (augmented_);
71 scm_gc_mark (diminished_);
72 scm_gc_mark (augmented_slash_);
75 bool group_is_equal_to (Stream_event *evt) const
78 ly_is_equal (number_, evt->get_property ("figure"))
79 && ly_is_equal (alteration_, evt->get_property ("alteration"))
80 && ly_is_equal (augmented_, evt->get_property ("augmented"))
81 && ly_is_equal (diminished_, evt->get_property ("diminished"))
82 && ly_is_equal (augmented_slash_, evt->get_property ("augmented-slash"))
83 && ly_is_equal (text_, evt->get_property ("text"));
85 bool is_continuation () const
89 && !force_no_continuation_
90 && group_is_equal_to (current_event_);
94 struct Figured_bass_engraver : public Engraver
96 TRANSLATOR_DECLARATIONS (Figured_bass_engraver);
97 void clear_spanners ();
101 void center_continuations (vector<Spanner*> const &consecutive_lines);
102 void center_repeated_continuations ();
104 vector<Figure_group> groups_;
106 vector<Stream_event *> new_events_;
108 bool new_event_found_;
111 Stream_event *rest_event_;
113 DECLARE_TRANSLATOR_LISTENER (rest);
114 DECLARE_TRANSLATOR_LISTENER (bass_figure);
116 virtual void derived_mark () const;
118 void start_translation_timestep ();
119 void stop_translation_timestep ();
120 void process_music ();
124 Figured_bass_engraver::derived_mark () const
126 for (vsize i = 0; i < groups_.size (); i++)
128 groups_[i].gc_mark ();
133 Figured_bass_engraver::stop_translation_timestep ()
136 || now_mom ().main_part_ < stop_moment_.main_part_
137 || now_mom ().grace_part_ < Rational (0))
141 for (vsize i = 0; !found && i < groups_.size (); i++)
142 found = found || groups_[i].current_event_;
148 Figured_bass_engraver::Figured_bass_engraver ()
151 continuation_ = false;
153 new_event_found_ = false;
157 Figured_bass_engraver::start_translation_timestep ()
159 if (now_mom ().main_part_ < stop_moment_.main_part_
160 || now_mom ().grace_part_ < Rational (0))
164 new_events_.clear ();
165 for (vsize i = 0; i < groups_.size (); i++)
166 groups_[i].current_event_ = 0;
168 continuation_ = false;
173 IMPLEMENT_TRANSLATOR_LISTENER (Figured_bass_engraver, rest);
175 Figured_bass_engraver::listen_rest (Stream_event *ev)
177 if (to_boolean (get_property ("ignoreFiguredBassRest")))
179 new_event_found_ = true;
182 No ASSIGN_EVENT_ONCE () ; otherwise we get warnings about
189 IMPLEMENT_TRANSLATOR_LISTENER (Figured_bass_engraver, bass_figure);
191 Figured_bass_engraver::listen_bass_figure (Stream_event *ev)
193 new_event_found_ = true;
194 Moment stop = now_mom () + get_event_length (ev, now_mom ());
195 stop_moment_ = max (stop_moment_, stop);
197 if (to_boolean (get_property ("useBassFigureExtenders")))
199 for (vsize i = 0; i < groups_.size (); i++)
201 if (!groups_[i].current_event_
202 && groups_[i].group_is_equal_to (ev))
204 groups_[i].current_event_ = ev;
205 groups_[i].force_no_continuation_
206 = to_boolean (ev->get_property ("no-continuation"));
207 continuation_ = true;
212 new_events_.push_back (ev);
216 Figured_bass_engraver::center_continuations (vector<Spanner*> const &consecutive_lines)
218 if (consecutive_lines.size () == 2)
220 vector<Grob*> left_figs;
221 for (vsize j = consecutive_lines.size (); j--;)
222 left_figs.push_back (consecutive_lines[j]->get_bound (LEFT));
224 SCM ga = Grob_array::make_array ();
225 unsmob_grob_array (ga)->set_array (left_figs);
227 for (vsize j = consecutive_lines.size (); j--;)
228 consecutive_lines[j]->set_object ("figures",
229 unsmob_grob_array (ga)->smobbed_copy ());
234 Figured_bass_engraver::center_repeated_continuations ()
236 vector<Spanner*> consecutive_lines;
237 for (vsize i = 0; i <= groups_.size (); i++)
239 if (i < groups_.size ()
240 && groups_[i].continuation_line_
241 && (consecutive_lines.empty ()
242 || (consecutive_lines[0]->get_bound (LEFT)->get_column ()
243 == groups_[i].continuation_line_->get_bound (LEFT)->get_column ()
244 && consecutive_lines[0]->get_bound (RIGHT)->get_column ()
245 == groups_[i].continuation_line_->get_bound (RIGHT)->get_column ())))
246 consecutive_lines.push_back (groups_[i].continuation_line_);
249 center_continuations (consecutive_lines);
250 consecutive_lines.clear ();
256 Figured_bass_engraver::clear_spanners ()
263 announce_end_grob (alignment_, SCM_EOL);
267 if (to_boolean (get_property ("figuredBassCenterContinuations")))
268 center_repeated_continuations ();
270 for (vsize i = 0; i < groups_.size (); i++)
272 if (groups_[i].group_)
274 announce_end_grob (groups_[i].group_ , SCM_EOL);
275 groups_[i].group_ = 0;
278 if (groups_[i].continuation_line_)
280 announce_end_grob (groups_[i].continuation_line_ , SCM_EOL);
281 groups_[i].continuation_line_ = 0;
285 /* Check me, groups_.clear () ? */
289 Figured_bass_engraver::add_brackets ()
291 vector<Grob*> encompass;
293 for (vsize i = 0; i < groups_.size (); i ++)
295 if (!groups_[i].current_event_)
298 if (to_boolean (groups_[i].current_event_->get_property ("bracket-start")))
301 if (inside && groups_[i].figure_item_)
302 encompass.push_back (groups_[i].figure_item_);
304 if (to_boolean (groups_[i].current_event_->get_property ("bracket-stop")))
308 Item * brack = make_item ("BassFigureBracket", groups_[i].current_event_->self_scm ());
309 for (vsize j = 0; j < encompass.size (); j++)
311 Pointer_group_interface::add_grob (brack,
312 ly_symbol2scm ("elements"),
321 Figured_bass_engraver::process_music ()
323 bool use_extenders = to_boolean (get_property ("useBassFigureExtenders"));
324 if (alignment_ && !use_extenders)
335 && new_events_.empty ())
342 if (!new_event_found_)
345 new_event_found_ = false;
348 Don't need to sync alignments, if we're not using extenders.
362 for (vsize i = 0; i < new_events_.size (); i++)
364 while (k < groups_.size ()
365 && groups_[k].current_event_)
368 if (k >= groups_.size ())
371 groups_.push_back (group);
374 groups_[k].current_event_ = new_events_[i];
375 groups_[k].figure_item_ = 0;
379 for (vsize i = 0; i < groups_.size (); i++)
381 if (!groups_[i].is_continuation ())
383 groups_[i].number_ = SCM_BOOL_F;
384 groups_[i].alteration_ = SCM_BOOL_F;
385 groups_[i].augmented_ = SCM_BOOL_F;
386 groups_[i].diminished_ = SCM_BOOL_F;
387 groups_[i].augmented_slash_ = SCM_BOOL_F;
388 groups_[i].text_ = SCM_BOOL_F;
394 vector<int> junk_continuations;
395 for (vsize i = 0; i < groups_.size (); i++)
397 Figure_group &group = groups_[i];
399 if (group.is_continuation ())
401 if (!group.continuation_line_)
404 = make_spanner ("BassFigureContinuation", SCM_EOL);
405 Item * item = group.figure_item_;
406 group.continuation_line_ = line;
407 line->set_bound (LEFT, item);
410 Don't add as child. This will cache the wrong
411 (pre-break) stencil when callbacks are triggered.
413 line->set_parent (group.group_, Y_AXIS);
414 Pointer_group_interface::add_grob (line, ly_symbol2scm ("figures"), item);
416 group.figure_item_ = 0;
419 else if (group.continuation_line_)
420 junk_continuations.push_back (i);
426 vector<Spanner*> consecutive;
427 if (to_boolean (get_property ("figuredBassCenterContinuations")))
429 for (vsize i = 0; i <= junk_continuations.size (); i++)
431 if (i < junk_continuations.size ()
432 && (i == 0 || junk_continuations[i-1] == junk_continuations[i] - 1))
433 consecutive.push_back (groups_[junk_continuations[i]].continuation_line_);
436 center_continuations (consecutive);
437 consecutive.clear ();
438 if (i < junk_continuations.size ())
439 consecutive.push_back (groups_[junk_continuations[i]].continuation_line_);
443 for (vsize i = 0; i < junk_continuations.size (); i++)
444 groups_[junk_continuations[i]].continuation_line_ = 0;
452 Figured_bass_engraver::create_grobs ()
455 = dynamic_cast<Item*> (unsmob_grob (get_property ("currentMusicalColumn")));
458 alignment_ = make_spanner ("BassFigureAlignment", SCM_EOL);
459 alignment_->set_bound (LEFT, muscol);
461 alignment_->set_bound (RIGHT, muscol);
463 SCM proc = get_property ("figuredBassFormatter");
464 for (vsize i = 0; i < groups_.size (); i++)
466 Figure_group &group = groups_[i];
468 if (group.current_event_)
471 = make_item ("BassFigure",
472 group.current_event_->self_scm ());
475 SCM fig = group.current_event_->get_property ("figure");
478 group.group_ = make_spanner ("BassFigureLine", SCM_EOL);
479 group.group_->set_bound (LEFT, muscol);
480 Align_interface::add_element (alignment_,
484 if (scm_memq (fig, get_property ("implicitBassFigures")) != SCM_BOOL_F)
486 item->set_property ("transparent", SCM_BOOL_T);
487 item->set_property ("implicit", SCM_BOOL_T);
491 group.alteration_ = group.current_event_->get_property ("alteration");
492 group.augmented_ = group.current_event_->get_property ("augmented");
493 group.diminished_ = group.current_event_->get_property ("diminished");
494 group.augmented_slash_ = group.current_event_->get_property ("augmented-slash");
495 group.text_ = group.current_event_->get_property ("text");
497 SCM text = group.text_;
498 if (!Text_interface::is_markup (text)
499 && ly_is_procedure (proc))
501 text = scm_call_3 (proc, fig, group.current_event_->self_scm (),
502 context ()->self_scm ());
505 item->set_property ("text", text);
507 Axis_group_interface::add_element (group.group_, item);
508 group.figure_item_ = item;
511 if (group.continuation_line_)
514 UGH should connect to the bass staff, and get the note heads.
516 group.figure_item_->set_property ("transparent", SCM_BOOL_T);
517 group.continuation_line_->set_bound (RIGHT, group.figure_item_);
520 if (groups_[i].group_)
521 groups_[i].group_->set_bound (RIGHT, muscol);
527 ADD_TRANSLATOR (Figured_bass_engraver,
529 "Make figured bass numbers.",
533 "BassFigureAlignment "
535 "BassFigureContinuation "
539 "figuredBassAlterationDirection "
540 "figuredBassCenterContinuations "
541 "figuredBassFormatter "
542 "implicitBassFigures "
543 "useBassFigureExtenders "
544 "ignoreFiguredBassRest ",