2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 1996--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
6 LilyPond is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 LilyPond is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
22 #include "align-interface.hh"
23 #include "all-font-metrics.hh"
24 #include "axis-group-interface.hh"
25 #include "break-align-interface.hh"
26 #include "grob-array.hh"
27 #include "hara-kiri-group-spanner.hh"
28 #include "international.hh"
31 #include "output-def.hh"
32 #include "page-layout-problem.hh"
33 #include "paper-column.hh"
34 #include "paper-score.hh"
35 #include "paper-system.hh"
36 #include "pointer-group-interface.hh"
37 #include "skyline-pair.hh"
38 #include "staff-symbol-referencer.hh"
39 #include "text-interface.hh"
41 #include "unpure-pure-container.hh"
43 System::System (System const &src)
49 checked_footnotes_ = false;
53 System::System (SCM s)
58 checked_footnotes_ = false;
63 System::init_elements ()
65 SCM scm_arr = Grob_array::make_array ();
66 all_elements_ = unsmob_grob_array (scm_arr);
67 all_elements_->set_ordered (false);
68 set_object ("all-elements", scm_arr);
72 System::clone () const
74 return new System (*this);
78 System::element_count () const
80 return all_elements_->size ();
84 System::spanner_count () const
87 for (vsize i = all_elements_->size (); i--;)
88 if (dynamic_cast<Spanner *> (all_elements_->grob (i)))
94 System::typeset_grob (Grob *elem)
97 programming_error ("adding element twice");
100 elem->layout_ = pscore_->layout ();
101 all_elements_->add (elem);
107 System::derived_mark () const
109 if (!all_elements_->empty ())
111 Grob **ptr = &all_elements_->array_reference ()[0];
112 Grob **end = ptr + all_elements_->size ();
115 scm_gc_mark ((*ptr)->self_scm ());
121 scm_gc_mark (pscore_->self_scm ());
123 Spanner::derived_mark ();
127 fixup_refpoints (vector<Grob *> const &grobs)
129 for (vsize i = grobs.size (); i--;)
130 grobs[i]->fixup_refpoint ();
134 System::do_break_substitution_and_fixup_refpoints ()
136 for (vsize i = 0; i < all_elements_->size (); i++)
138 Grob *g = all_elements_->grob (i);
139 if (g->internal_has_interface (ly_symbol2scm ("only-prebreak-interface")))
142 Kill no longer needed grobs.
144 Item *it = dynamic_cast<Item *> (g);
145 if (it && Item::is_non_musical (it))
147 it->find_prebroken_piece (LEFT)->suicide ();
148 it->find_prebroken_piece (RIGHT)->suicide ();
152 else if (g->is_live ())
153 g->do_break_processing ();
157 fixups must be done in broken line_of_scores, because new elements
158 are put over there. */
160 for (vsize i = 0; i < broken_intos_.size (); i++)
162 Grob *se = broken_intos_[i];
164 extract_grob_set (se, "all-elements", all_elts);
165 for (vsize j = 0; j < all_elts.size (); j++)
167 Grob *g = all_elts[j];
168 g->fixup_refpoint ();
171 count += all_elts.size ();
175 needed for doing items.
177 fixup_refpoints (all_elements_->array ());
179 for (vsize i = 0; i < all_elements_->size (); i++)
180 all_elements_->grob (i)->handle_broken_dependencies ();
182 handle_broken_dependencies ();
184 /* Because the this->get_property (all-elements) contains items in 3
185 versions, handle_broken_dependencies () will leave duplicated
186 items in all-elements. Strictly speaking this is harmless, but
187 it leads to duplicated symbols in the output. uniq makes sure
188 that no duplicates are in the list. */
189 for (vsize i = 0; i < broken_intos_.size (); i++)
191 System *child = dynamic_cast<System *> (broken_intos_[i]);
192 child->all_elements_->remove_duplicates ();
193 for (vsize j = 0; j < child->all_elements_->size (); j++)
195 Grob *g = child->all_elements_->grob (j);
197 (void) g->get_property ("after-line-breaking");
201 debug_output (_f ("Element count %d", count + element_count ()) + "\n");
205 System::get_broken_system_grobs ()
208 for (vsize i = 0; i < broken_intos_.size (); i++)
209 ret = scm_cons (broken_intos_[i]->self_scm (), ret);
210 return scm_reverse (ret);
214 System::get_paper_systems ()
216 SCM lines = scm_c_make_vector (broken_intos_.size (), SCM_EOL);
217 for (vsize i = 0; i < broken_intos_.size (); i++)
219 debug_output ("[", false);
221 System *system = dynamic_cast<System *> (broken_intos_[i]);
223 scm_vector_set_x (lines, scm_from_int (i),
224 system->get_paper_system ());
226 debug_output (to_string (i) + "]", false);
232 System::populate_footnote_grob_vector ()
234 extract_grob_set (this, "all-elements", all_elts);
235 for (vsize i = 0; i < all_elts.size (); i++)
236 if (all_elts[i]->internal_has_interface (ly_symbol2scm ("footnote-interface")))
237 footnote_grobs_.push_back (all_elts[i]);
239 sort (footnote_grobs_.begin (), footnote_grobs_.end (), Grob::less);
240 checked_footnotes_ = true;
244 System::get_footnote_grobs_in_range (vector<Grob *> &out, vsize start, vsize end)
246 if (!checked_footnotes_)
247 populate_footnote_grob_vector ();
249 for (vsize i = 0; i < footnote_grobs_.size (); i++)
251 int pos = footnote_grobs_[i]->spanned_rank_interval ()[LEFT];
252 if (Spanner *s = dynamic_cast<Spanner *>(footnote_grobs_[i]))
254 Direction spanner_placement = robust_scm2dir (s->get_property ("spanner-placement"), LEFT);
255 if (spanner_placement == CENTER)
256 spanner_placement = LEFT;
258 pos = s->spanned_rank_interval ()[spanner_placement];
261 if (Item *item = dynamic_cast<Item *>(footnote_grobs_[i]))
263 if (!Item::break_visible (item))
265 // safeguard to bring down the column rank so that end of line footnotes show up on the correct line
266 if (pos == int (start) && item->break_status_dir () != RIGHT)
268 if (pos == int (end) && item->break_status_dir () != LEFT)
270 if (pos != int (end) && pos != int (start) && item->break_status_dir () != CENTER)
274 if (pos < int (start))
278 if (!footnote_grobs_[i]->is_live ())
281 out.push_back (footnote_grobs_[i]);
286 System::get_footnote_heights_in_range (vsize start, vsize end)
288 return internal_get_note_heights_in_range (start, end, true);
292 System::get_in_note_heights_in_range (vsize start, vsize end)
294 return internal_get_note_heights_in_range (start, end, false);
298 System::internal_get_note_heights_in_range (vsize start, vsize end, bool foot)
300 vector<Grob *> footnote_grobs;
301 get_footnote_grobs_in_range (footnote_grobs, start, end);
304 for (vsize i = footnote_grobs.size (); i--;)
306 ? !to_boolean (footnote_grobs[i]->get_property ("footnote"))
307 : to_boolean (footnote_grobs[i]->get_property ("footnote")))
308 footnote_grobs.erase (footnote_grobs.begin () + i);
310 for (vsize i = 0; i < footnote_grobs.size (); i++)
312 SCM footnote_markup = footnote_grobs[i]->get_property ("footnote-text");
314 if (!Text_interface::is_markup (footnote_markup))
317 SCM props = scm_call_1 (ly_lily_module_constant ("layout-extract-page-properties"),
318 pscore_->layout ()->self_scm ());
320 SCM footnote_stl = Text_interface::interpret_markup (pscore_->layout ()->self_scm (),
321 props, footnote_markup);
323 Stencil *footnote_stencil = unsmob_stencil (footnote_stl);
324 out.push_back (footnote_stencil->extent (Y_AXIS).length ());
331 System::num_footnotes ()
333 return footnote_grobs_.size ();
337 System::footnote_grobs ()
339 return &footnote_grobs_;
343 System::break_into_pieces (vector<Column_x_positions> const &breaking)
345 for (vsize i = 0; i < breaking.size (); i++)
347 System *system = dynamic_cast<System *> (clone ());
348 system->rank_ = broken_intos_.size ();
350 vector<Grob *> c (breaking[i].cols_);
351 pscore_->typeset_system (system);
353 int st = Paper_column::get_rank (c[0]);
354 int end = Paper_column::get_rank (c.back ());
355 Interval iv (pure_height (this, st, end));
356 system->set_property ("pure-Y-extent", ly_interval2scm (iv));
358 get_footnote_grobs_in_range (system->footnote_grobs_, st, end);
360 system->set_bound (LEFT, c[0]);
361 system->set_bound (RIGHT, c.back ());
362 SCM system_labels = SCM_EOL;
363 for (vsize j = 0; j < c.size (); j++)
365 c[j]->translate_axis (breaking[i].config_[j], X_AXIS);
366 dynamic_cast<Paper_column *> (c[j])->set_system (system);
367 /* collect the column labels */
368 collect_labels (c[j], &system_labels);
371 Collect labels from any loose columns too: theses will be set on
372 an empty bar line or a column which is otherwise unused mid-line
374 vector<Grob *> loose (breaking[i].loose_cols_);
375 for (vsize j = 0; j < loose.size (); j++)
376 collect_labels (loose[j], &system_labels);
378 system->set_property ("labels", system_labels);
380 set_loose_columns (system, &breaking[i]);
381 broken_intos_.push_back (system);
386 System::collect_labels (Grob const *col, SCM *labels)
388 SCM col_labels = col->get_property ("labels");
389 if (scm_is_pair (col_labels))
390 *labels = scm_append (scm_list_2 (col_labels, *labels));
394 System::add_column (Paper_column *p)
397 Grob_array *ga = unsmob_grob_array (me->get_object ("columns"));
400 SCM scm_ga = Grob_array::make_array ();
401 me->set_object ("columns", scm_ga);
402 ga = unsmob_grob_array (scm_ga);
405 p->set_rank (ga->size ());
408 Axis_group_interface::add_element (this, p);
412 System::pre_processing ()
414 for (vsize i = 0; i < all_elements_->size (); i++)
415 all_elements_->grob (i)->discretionary_processing ();
417 debug_output (_f ("Grob count %d", element_count ()));
420 order is significant: broken grobs are added to the end of the
421 array, and should be processed before the original is potentially
424 for (vsize i = all_elements_->size (); i--;)
425 all_elements_->grob (i)->handle_prebroken_dependencies ();
427 fixup_refpoints (all_elements_->array ());
429 for (vsize i = 0; i < all_elements_->size (); i++)
431 Grob *g = all_elements_->grob (i);
432 (void) g->get_property ("before-line-breaking");
435 for (vsize i = 0; i < all_elements_->size (); i++)
437 Grob *e = all_elements_->grob (i);
438 (void) e->get_property ("springs-and-rods");
443 System::post_processing ()
445 Interval iv (extent (this, Y_AXIS));
447 programming_error ("system with empty extent");
449 translate_axis (-iv[MAX], Y_AXIS);
451 /* Generate all stencils to trigger font loads.
452 This might seem inefficient, but Stencils are cached per grob
455 vector<Grob *> all_elts_sorted (all_elements_->array ());
456 vector_sort (all_elts_sorted, std::less<Grob *> ());
457 uniq (all_elts_sorted);
458 this->get_stencil ();
459 for (vsize i = all_elts_sorted.size (); i--;)
461 Grob *g = all_elts_sorted[i];
473 operator < (Layer_entry const &a,
474 Layer_entry const &b)
476 return a.layer_ < b.layer_;
480 System::get_paper_system ()
487 vector<Layer_entry> entries;
488 for (vsize j = 0; j < all_elements_->size (); j++)
491 e.grob_ = all_elements_->grob (j);
492 e.layer_ = robust_scm2int (e.grob_->get_property ("layer"), 1);
494 entries.push_back (e);
497 vector_sort (entries, std::less<Layer_entry> ());
498 for (vsize j = 0; j < entries.size (); j++)
500 Grob *g = entries[j].grob_;
501 Stencil st = g->get_print_stencil ();
503 if (st.expr () == SCM_EOL)
507 for (int a = X_AXIS; a < NO_AXES; a++)
508 o[Axis (a)] = g->relative_coordinate (this, Axis (a));
510 Offset extra = robust_scm2offset (g->get_property ("extra-offset"),
512 * Staff_symbol_referencer::staff_space (g);
514 /* Must copy the stencil, for we cannot change the stencil
517 st.translate (o + extra);
519 *tail = scm_cons (st.expr (), SCM_EOL);
520 tail = SCM_CDRLOC (*tail);
523 if (Stencil *me = get_stencil ())
524 exprs = scm_cons (me->expr (), exprs);
526 Interval x (extent (this, X_AXIS));
527 Interval y (extent (this, Y_AXIS));
528 Stencil sys_stencil (Box (x, y),
529 scm_cons (ly_symbol2scm ("combine-stencil"),
533 Skyline_pair *skylines = Skyline_pair::unsmob (get_property ("vertical-skylines"));
537 = Lookup::points_to_line_stencil (0.1, (*skylines)[UP].to_points (X_AXIS));
539 = Lookup::points_to_line_stencil (0.1, (*skylines)[DOWN].to_points (X_AXIS));
540 sys_stencil.add_stencil (up.in_color (255, 0, 0));
541 sys_stencil.add_stencil (down.in_color (0, 255, 0));
545 Grob *left_bound = this->get_bound (LEFT);
546 SCM prop_init = left_bound->get_property ("line-break-system-details");
547 Prob *pl = make_paper_system (prop_init);
548 paper_system_set_stencil (pl, sys_stencil);
550 /* information that the page breaker might need */
551 Grob *right_bound = this->get_bound (RIGHT);
552 pl->set_property ("vertical-skylines", this->get_property ("vertical-skylines"));
553 pl->set_property ("page-break-permission", right_bound->get_property ("page-break-permission"));
554 pl->set_property ("page-turn-permission", right_bound->get_property ("page-turn-permission"));
555 pl->set_property ("page-break-penalty", right_bound->get_property ("page-break-penalty"));
556 pl->set_property ("page-turn-penalty", right_bound->get_property ("page-turn-penalty"));
558 if (right_bound->original () == dynamic_cast<System*> (original ())->get_bound (RIGHT))
559 pl->set_property ("last-in-score", SCM_BOOL_T);
561 Interval staff_refpoints;
562 if (Grob *align = get_vertical_alignment ())
564 extract_grob_set (align, "elements", staves);
565 for (vsize i = 0; i < staves.size (); i++)
566 if (staves[i]->is_live ()
567 && Page_layout_problem::is_spaceable (staves[i]))
568 staff_refpoints.add_point (staves[i]->relative_coordinate (this,
572 pl->set_property ("staff-refpoint-extent", ly_interval2scm (staff_refpoints));
573 pl->set_property ("system-grob", this->self_scm ());
575 return pl->unprotect ();
579 System::broken_col_range (Item const *left, Item const *right) const
583 left = left->get_column ();
584 right = right->get_column ();
586 extract_grob_set (this, "columns", cols);
588 vsize i = Paper_column::get_rank (left);
589 int end_rank = Paper_column::get_rank (right);
590 if (i < cols.size ())
593 while (i < cols.size ()
594 && Paper_column::get_rank (cols[i]) < end_rank)
596 Paper_column *c = dynamic_cast<Paper_column *> (cols[i]);
597 if (Paper_column::is_breakable (c) && !c->get_system ())
605 /** Return all columns, but filter out any unused columns , since they might
606 disrupt the spacing problem. */
608 System::used_columns () const
610 extract_grob_set (this, "columns", ro_columns);
612 int last_breakable = ro_columns.size ();
614 while (last_breakable--)
616 if (Paper_column::is_breakable (ro_columns [last_breakable]))
620 vector<Grob *> columns;
621 for (int i = 0; i <= last_breakable; i++)
623 if (Paper_column::is_used (ro_columns[i]))
624 columns.push_back (ro_columns[i]);
631 System::column (vsize which) const
633 extract_grob_set (this, "columns", columns);
634 if (which >= columns.size ())
637 return dynamic_cast<Paper_column *> (columns[which]);
641 System::paper_score () const
647 System::get_rank () const
653 get_root_system (Grob *me)
655 Grob *system_grob = me;
657 while (system_grob->get_parent (Y_AXIS))
658 system_grob = system_grob->get_parent (Y_AXIS);
660 return dynamic_cast<System *> (system_grob);
664 System::get_vertical_alignment ()
666 extract_grob_set (this, "elements", elts);
668 for (vsize i = 0; i < elts.size (); i++)
669 if (Align_interface::has_interface (elts[i]))
672 programming_error ("found multiple vertical alignments in this system");
677 programming_error ("didn't find a vertical alignment in this system");
681 // Finds the furthest staff in the given direction whose x-extent
682 // overlaps with the given interval.
684 System::get_extremal_staff (Direction dir, Interval const &iv)
686 Grob *align = get_vertical_alignment ();
690 extract_grob_set (align, "elements", elts);
691 vsize start = (dir == UP) ? 0 : elts.size () - 1;
692 vsize end = (dir == UP) ? elts.size () : VPOS;
693 for (vsize i = start; i != end; i += dir)
695 if (Hara_kiri_group_spanner::has_interface (elts[i]))
696 Hara_kiri_group_spanner::consider_suicide (elts[i]);
698 Interval intersection = elts[i]->extent (this, X_AXIS);
699 intersection.intersect (iv);
700 if (elts[i]->is_live () && !intersection.is_empty ())
707 System::pure_refpoint_extent (vsize start, vsize end)
710 Grob *alignment = get_vertical_alignment ();
714 extract_grob_set (alignment, "elements", staves);
715 vector<Real> offsets = Align_interface::get_pure_minimum_translations (alignment, staves, Y_AXIS, start, end);
717 for (vsize i = 0; i < offsets.size (); ++i)
718 if (Page_layout_problem::is_spaceable (staves[i]))
720 ret[UP] = offsets[i];
724 for (vsize i = offsets.size (); i--;)
725 if (Page_layout_problem::is_spaceable (staves[i]))
727 ret[DOWN] = offsets[i];
735 System::part_of_line_pure_height (vsize start, vsize end, bool begin)
737 Grob *alignment = get_vertical_alignment ();
741 extract_grob_set (alignment, "elements", staves);
742 vector<Real> offsets = Align_interface::get_pure_minimum_translations (alignment, staves, Y_AXIS, start, end);
745 for (vsize i = 0; i < staves.size (); ++i)
748 ? Axis_group_interface::begin_of_line_pure_height (staves[i], start)
749 : Axis_group_interface::rest_of_line_pure_height (staves[i], start, end);
750 if (i < offsets.size ())
751 iv.translate (offsets[i]);
755 Interval other_elements = begin
756 ? Axis_group_interface::begin_of_line_pure_height (this, start)
757 : Axis_group_interface::rest_of_line_pure_height (this, start, end);
759 ret.unite (other_elements);
765 System::begin_of_line_pure_height (vsize start, vsize end)
767 return part_of_line_pure_height (start, end, true);
771 System::rest_of_line_pure_height (vsize start, vsize end)
773 return part_of_line_pure_height (start, end, false);
776 // This differs from Axis_group_interface::calc_pure_relevant_grobs
777 // because here, we are only interested in those few elements that aren't
778 // descended from VerticalAlignment (ie. things like RehearsalMark, BarLine).
779 MAKE_SCHEME_CALLBACK (System, calc_pure_relevant_grobs, 1);
781 System::calc_pure_relevant_grobs (SCM smob)
783 Grob *me = unsmob_grob (smob);
785 extract_grob_set (me, "elements", elts);
786 vector<Grob *> relevant_grobs;
787 SCM pure_relevant_p = ly_lily_module_constant ("pure-relevant?");
789 for (vsize i = 0; i < elts.size (); ++i)
791 if (!Axis_group_interface::has_interface (elts[i]))
793 if (to_boolean (scm_apply_1 (pure_relevant_p, elts[i]->self_scm (), SCM_EOL)))
794 relevant_grobs.push_back (elts[i]);
796 if (Item *it = dynamic_cast<Item *> (elts[i]))
801 Item *piece = it->find_prebroken_piece (d);
802 if (piece && to_boolean (scm_apply_1 (pure_relevant_p, piece->self_scm (), SCM_EOL)))
803 relevant_grobs.push_back (piece);
805 while (flip (&d) != LEFT);
810 SCM grobs_scm = Grob_array::make_array ();
812 unsmob_grob_array (grobs_scm)->set_array (relevant_grobs);
816 MAKE_SCHEME_CALLBACK (System, height, 1);
818 System::height (SCM smob)
820 return Axis_group_interface::height (smob);
823 MAKE_SCHEME_CALLBACK (System, calc_pure_height, 3);
825 System::calc_pure_height (SCM smob, SCM start_scm, SCM end_scm)
827 System *me = dynamic_cast<System *> (unsmob_grob (smob));
828 int start = scm_to_int (start_scm);
829 int end = scm_to_int (end_scm);
831 Interval begin = me->begin_of_line_pure_height (start, end);
832 Interval rest = me->rest_of_line_pure_height (start, end);
835 return ly_interval2scm (begin);
839 System::get_pure_bound (Direction d, int start, int end)
841 vector<vsize> ranks = pscore_->get_break_ranks ();
842 vector<vsize> indices = pscore_->get_break_indices ();
843 vector<Grob *> cols = pscore_->get_columns ();
845 vsize target_rank = (d == LEFT ? start : end);
846 vector<vsize>::const_iterator i
847 = lower_bound (ranks.begin (), ranks.end (), target_rank, std::less<vsize> ());
849 if (i != ranks.end () && (*i) == target_rank)
850 return cols[indices[i - ranks.begin ()]];
856 System::get_maybe_pure_bound (Direction d, bool pure, int start, int end)
858 return pure ? get_pure_bound (d, start, end) : get_bound (d);
868 get_maybe_spaceable_staves (SCM smob, int filter)
870 System *me = dynamic_cast<System*> (unsmob_grob (smob));
871 Grob *align = me->get_vertical_alignment ();
877 extract_grob_set (align, "elements", staves);
879 for (vsize i = 0; i < staves.size (); ++i)
881 bool spaceable = Page_layout_problem::is_spaceable (staves[i]);
882 if (staves[i]->is_live () &&
883 ((filter == ALL_STAVES)
884 || (filter == SPACEABLE_STAVES && spaceable)
885 || (filter == NONSPACEABLE_STAVES && !spaceable)))
887 *tail = scm_cons (staves[i]->self_scm (), SCM_EOL);
888 tail = SCM_CDRLOC (*tail);
896 MAKE_SCHEME_CALLBACK (System, get_staves, 1)
898 System::get_staves (SCM smob)
900 return get_maybe_spaceable_staves (smob, ALL_STAVES);
903 MAKE_SCHEME_CALLBACK (System, get_spaceable_staves, 1)
905 System::get_spaceable_staves (SCM smob)
907 return get_maybe_spaceable_staves (smob, SPACEABLE_STAVES);
910 MAKE_SCHEME_CALLBACK (System, get_nonspaceable_staves, 1)
912 System::get_nonspaceable_staves (SCM smob)
914 return get_maybe_spaceable_staves (smob, NONSPACEABLE_STAVES);
918 ADD_INTERFACE (System,
919 "This is the top-level object: Each object in a score"
920 " ultimately has a @code{System} object as its X and"
932 "skyline-horizontal-padding "