2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 1997--2012 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 "axis-group-interface.hh"
23 #include "paper-score.hh"
25 #include "paper-column.hh"
26 #include "lily-guile.hh"
28 #include "pointer-group-interface.hh"
35 return new Item (*this);
41 broken_to_drul_[LEFT] = broken_to_drul_[RIGHT] = 0;
42 cached_pure_height_valid_ = false;
46 Item copy ctor. Copy nothing: everything should be a elt property
47 or a special purpose pointer (such as broken_to_drul_[]) */
48 Item::Item (Item const &s)
51 broken_to_drul_[LEFT] = broken_to_drul_[RIGHT] = 0;
52 cached_pure_height_valid_ = false;
56 Item::is_non_musical (Grob *me)
58 Item *i = dynamic_cast<Item *> (me->get_parent (X_AXIS));
59 return i ? Item::is_non_musical (i) : to_boolean (me->get_property ("non-musical"));
63 Item::get_column () const
65 Item *parent = dynamic_cast<Item *> (get_parent (X_AXIS));
66 return parent ? parent->get_column () : 0;
70 Item::get_system () const
72 Grob *g = get_parent (X_AXIS);
73 return g ? g->get_system () : 0;
77 Item::copy_breakable_items ()
79 Drul_array<Item *> new_copies;
83 Grob *dolly = clone ();
84 Item *item = dynamic_cast<Item *> (dolly);
85 get_root_system (this)->typeset_grob (item);
88 while (flip (&i) != LEFT);
90 broken_to_drul_ = new_copies;
94 Item::is_broken () const
96 return broken_to_drul_[LEFT] || broken_to_drul_[RIGHT];
100 Generate items for begin and end-of line.
103 Item::discretionary_processing ()
105 if (is_broken () || original ())
108 if (Item::is_non_musical (this))
109 copy_breakable_items ();
113 Item::find_broken_piece (System *l) const
115 if (get_system () == l)
116 return (Item *) (this);
121 Grob *s = broken_to_drul_[d];
122 if (s && s->get_system () == l)
125 while (flip (&d) != LEFT);
131 Item::find_prebroken_piece (Direction d) const
133 Item *me = (Item *) (this);
136 return dynamic_cast<Item *> (broken_to_drul_[d]);
140 Item::break_status_dir () const
144 Item *i = dynamic_cast<Item *> (original ());
146 return (i->broken_to_drul_[LEFT] == this) ? LEFT : RIGHT;
153 Item::handle_prebroken_dependencies ()
155 Grob::handle_prebroken_dependencies ();
158 Can't do this earlier, because try_visibility_lambda () might set
159 the elt property transparent, which would then be copied.
161 if (!Item::break_visible (this))
166 Item::break_visible (Grob *g)
168 Item *it = dynamic_cast<Item *> (g);
169 SCM vis = g->get_property ("break-visibility");
170 if (scm_is_vector (vis))
171 return to_boolean (scm_c_vector_ref (vis, it->break_status_dir () + 1));
176 Item::pure_is_visible (int start, int end) const
178 SCM vis = get_property ("break-visibility");
179 if (scm_is_vector (vis))
182 int pc_rank = Paper_column::get_rank (get_column ());
183 if (pc_rank == start)
185 else if (pc_rank == end)
187 return to_boolean (scm_vector_ref (vis, scm_from_int (pos)));
193 Item::spanned_rank_interval () const
195 int c = get_column ()->get_rank ();
196 return Interval_t<int> (c, c);
200 spanned_time_interval (Item *l, Item *r)
202 Drul_array<Item *> bounds (l, r);
203 Interval_t<Moment> iv;
208 if (bounds[d] && bounds[d]->get_column ())
209 iv[d] = robust_scm2moment (bounds[d]->get_column ()->get_property ("when"),
212 while (flip (&d) != LEFT);
216 if (!bounds[d] || !bounds[d]->get_column ())
219 while (flip (&d) != LEFT);
225 Item::derived_mark () const
227 if (broken_to_drul_[LEFT])
228 scm_gc_mark (broken_to_drul_[LEFT]->self_scm ());
229 if (broken_to_drul_[RIGHT])
230 scm_gc_mark (broken_to_drul_[RIGHT]->self_scm ());
236 return dynamic_cast<Item *> (unsmob_grob (s));
240 Item::pure_height (Grob *g, int start, int end)
242 if (cached_pure_height_valid_)
243 return cached_pure_height_ + pure_relative_y_coordinate (g, start, end);
244 /* Note: cached_pure_height_ does not notice if start changes, implicitly
245 assuming that Items' pure_heights do not depend on 'start' or 'end'.
246 Accidental_interface::pure_height(), however, does depend on 'start'.
249 cache_pure_height (Grob::pure_height (this, start, end));
250 return cached_pure_height_ + pure_relative_y_coordinate (g, start, end);
254 Item::cache_pure_height (Interval height)
256 cached_pure_height_ = height;
257 cached_pure_height_valid_ = true;
261 "Grobs can be distinguished in their role in the horizontal"
262 " spacing. Many grobs define constraints on the spacing by"
263 " their sizes, for example, note heads, clefs, stems, and all"
264 " other symbols with a fixed shape. These grobs form a"
265 " subtype called @code{Item}.\n"
267 "Some items need special treatment for line breaking. For"
268 " example, a clef is normally only printed at the start of a"
269 " line (i.e., after a line break). To model this,"
270 " @q{breakable} items (clef, key signature, bar lines, etc.)"
271 " are copied twice. Then we have three versions of each"
272 " breakable item: one version if there is no line break, one"
273 " version that is printed before the line break (at the end of"
274 " a system), and one version that is printed after the line"
277 "Whether these versions are visible and take up space is"
278 " determined by the outcome of the @code{break-visibility}"
279 " grob property, which is a function taking a direction"
280 " (@w{@code{-1}}, @code{0} or@tie{}@code{1}) as an argument. It"
281 " returns a cons of booleans, signifying whether this grob"
282 " should be transparent and have no extent.\n"
284 "The following variables for @code{break-visibility} are"
287 " grob will show: before no after\n"
288 " break break break\n"
289 " all-invisible no no no\n"
290 " begin-of-line-visible no no yes\n"
291 " end-of-line-visible yes no no\n"
292 " all-visible yes yes yes\n"
293 " begin-of-line-invisible yes yes no\n"
294 " end-of-line-invisible no yes yes\n"
295 " center-invisible yes no yes\n"
300 "extra-spacing-height "
301 "extra-spacing-width "