2 score-engraver.cc -- implement Score_engraver
4 source file of the GNU LilyPond music typesetter
6 (c) 1997--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
9 #include "all-font-metrics.hh"
14 #include "score-engraver.hh"
15 #include "paper-score.hh"
16 #include "paper-column.hh"
17 #include "output-def.hh"
18 #include "axis-group-interface.hh"
19 #include "context-def.hh"
20 #include "staff-spacing.hh"
21 #include "note-spacing.hh"
22 #include "global-context.hh"
25 TODO: the column creation logic is rather hairy. Revise it.
27 Score_engraver::Score_engraver ()
37 Score_engraver::make_columns ()
45 = updated_grob_properties (context (),
46 ly_symbol2scm ("NonMusicalPaperColumn"));
48 Object_key const *key1 = context()->get_grob_key ("NonMusicalPaperColumn");
50 SCM pc = updated_grob_properties (context (),
51 ly_symbol2scm ("PaperColumn"));
52 Object_key const *key2 = context()->get_grob_key ("PaperColumn");
53 set_columns (new Paper_column (nmp, key1), new Paper_column (pc, key2));
57 i1.grob_ = command_column_;
58 i1.origin_trans_ = this;
63 i2.grob_ = musical_column_;
64 i2.origin_trans_ = this;
71 Score_engraver::prepare (Moment m)
74 TODO: don't make columns when skipTypesetting is true.
78 SCM w = m.smobbed_copy ();
79 command_column_->set_property ("when", w);
80 musical_column_->set_property ("when", w);
82 recurse_over_translators (context (), &Translator::start_translation_timestep, DOWN);
86 Score_engraver::finish ()
89 progress_indication ("[" + to_string (breaks_) + "]");
91 recurse_over_translators (context (), &Translator::finalize, UP);
98 Score_engraver::initialize ()
100 Font_metric *fm = all_fonts_global->find_afm ("feta20");
102 error (_f ("cannot find `%s'", "feta20.afm")
104 + _ ("Music font has not been installed properly.")
107 if (!scm_is_string (ly_kpathsea_find_file (scm_makfrom0str ("ecrm10.pfa")))
108 && (!scm_is_string (ly_kpathsea_find_file (scm_makfrom0str ("lmr10.pfb")))))
109 error (_f ("cannot find `%s'", "ecrm10.pfa")
111 + _f ("cannot find `%s'", "lmr10.pfb")
113 + _f ("Install the ec-fonts-mftraced package from: %s.",
114 "http://lilypond.org/download/fonts/")
118 pscore_ = new Paper_score;
119 pscore_->layout_ = dynamic_cast<Output_def*> (get_output_def ());
121 SCM props = updated_grob_properties (context (), ly_symbol2scm ("System"));
123 Object_key const *sys_key = context()->get_grob_key ("System");
124 pscore_->typeset_line (new System (props, sys_key));
127 system_ = pscore_->system_;
128 system_->set_bound (LEFT, command_column_);
129 command_column_->set_property ("breakable", SCM_BOOL_T);
131 Engraver_group_engraver::initialize ();
136 Score_engraver::finalize ()
138 Score_translator::finalize ();
141 = unsmob_grob (get_property ("currentCommandColumn"));
142 system_->set_bound (RIGHT, cc);
143 cc->set_property ("breakable", SCM_BOOL_T);
150 Score_engraver::one_time_step ()
152 if (!to_boolean (get_property ("skipTypesetting")))
154 recurse_over_translators (context (), &Engraver::process_music, UP);
155 Engraver_group_engraver::do_announces();
158 recurse_over_translators (context (), &Translator::stop_translation_timestep, UP);
162 Score_engraver::announce_grob (Grob_info info)
164 announce_infos_.push (info);
165 pscore_->system_->typeset_grob (info.grob_);
166 elems_.push (info.grob_);
171 Score_engraver::typeset_all ()
173 for (int i =0; i < elems_.size (); i++)
175 Grob * elem = elems_[i];
178 if (dynamic_cast<Item*> (elem))
180 if (!elem->get_parent (X_AXIS)
181 && elem != command_column_
182 && elem != musical_column_
185 bool br = to_boolean (elem->get_property ("breakable"));
186 Axis_group_interface::add_element (br ? command_column_ : musical_column_, elem);
190 if (!elem->get_parent (Y_AXIS))
191 Axis_group_interface::add_element (system_, elem);
197 Score_engraver::stop_translation_timestep ()
199 // this generates all items.
200 Engraver_group_engraver::stop_translation_timestep ();
203 if (to_boolean (command_column_->get_property ("breakable")))
207 progress_indication ("[" + to_string (breaks_) + "]");
211 system_->add_column (command_column_);
212 system_->add_column (musical_column_);
219 Score_engraver::set_columns (Paper_column *new_command,
220 Paper_column *new_musical)
222 assert (!command_column_ && !musical_column_);
224 command_column_ = new_command;
225 musical_column_ = new_musical;
228 context ()->set_property ("currentCommandColumn", new_command->self_scm ());
233 context ()->set_property ("currentMusicalColumn", new_musical->self_scm ());
238 Score_engraver::get_output ()
240 Music_output *o = pscore_;
241 ///FIXME WTF? pscore_ = 0;
246 Score_engraver::try_music (Music *m)
248 if (Engraver_group_engraver::try_music (m))
251 if (m->is_mus_type ("break-event"))
253 SCM pen = command_column_->get_property ("penalty");
254 Real total_penalty = scm_is_number (pen) ? scm_to_double (pen) : 0.0;
256 SCM mpen = m->get_property ("penalty");
257 if (scm_is_number (mpen))
258 total_penalty += scm_to_double (mpen);
260 command_column_->set_property ("penalty", scm_make_real (total_penalty));
262 /* ugh. arbitrary, hardcoded */
263 if (total_penalty > 10000.0)
266 SCM page_pen = command_column_->get_property ("page-penalty");
267 Real total_pp = scm_is_number (page_pen) ? scm_to_double (page_pen) : 0.0;
268 SCM mpage_pen = m->get_property ("page-penalty");
269 if (scm_is_number (mpage_pen))
270 total_pp += scm_to_double (mpage_pen);
272 command_column_->set_property ("page-penalty", scm_make_real (total_pp));
279 Score_engraver::forbid_breaks ()
282 command_column_->set_property ("breakable", SCM_EOL);
286 Score_engraver::acknowledge_grob (Grob_info gi)
288 if (Staff_spacing::has_interface (gi.grob_))
290 Pointer_group_interface::add_grob (command_column_,
291 ly_symbol2scm ("spacing-wishes"),
294 if (Note_spacing::has_interface (gi.grob_))
296 Pointer_group_interface::add_grob (musical_column_,
297 ly_symbol2scm ("spacing-wishes"),
301 if (Axis_group_interface::has_interface (gi.grob_)
302 && gi.grob_->internal_has_interface (ly_symbol2scm ("vertically-spaceable-interface")))
304 SCM spaceable = get_property ("verticallySpacedContexts");
305 Context *orig = gi.origin_contexts (this)[0];
307 if (scm_memq (ly_symbol2scm (orig->context_name ().to_str0()),
308 spaceable) != SCM_BOOL_F)
310 Pointer_group_interface::add_grob (system_,
311 ly_symbol2scm ("spaceable-staves"),
320 ENTER_DESCRIPTION (Score_engraver,
321 /* descr */ "Top level engraver. Takes care of generating columns and the complete system (ie. System) "
323 "This engraver decides whether a column is breakable. The default is "
324 "that a column is always breakable. However, when every Bar_engraver "
325 "that does not have a barline at a certain point will call "
326 "Score_engraver::forbid_breaks to stop linebreaks. In practice, this "
327 "means that you can make a breakpoint by creating a barline (assuming "
328 "that there are no beams or notes that prevent a breakpoint.) "
330 /* creats*/ "System PaperColumn NonMusicalPaperColumn",
331 /* accepts */ "break-event",
332 /* acks */ "note-spacing-interface staff-spacing-interface axis-group-interface",
333 /* reads */ "currentMusicalColumn currentCommandColumn verticallySpacedContexts",