2 axis-group-interface.cc -- implement Axis_group_interface
4 source file of the GNU LilyPond music typesetter
6 (c) 2000--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
9 #include "axis-group-interface.hh"
11 #include "align-interface.hh"
12 #include "directional-element-interface.hh"
13 #include "pointer-group-interface.hh"
14 #include "grob-array.hh"
15 #include "hara-kiri-group-spanner.hh"
16 #include "international.hh"
17 #include "paper-column.hh"
18 #include "paper-score.hh"
23 Axis_group_interface::add_element (Grob *me, Grob *e)
25 SCM axes = me->get_property ("axes");
26 if (!scm_is_pair (axes))
27 programming_error ("axes should be nonempty");
29 for (SCM ax = axes; scm_is_pair (ax); ax = scm_cdr (ax))
31 Axis a = (Axis) scm_to_int (scm_car (ax));
33 if (!e->get_parent (a))
34 e->set_parent (me, a);
36 e->set_object ((a == X_AXIS)
37 ? ly_symbol2scm ("axis-group-parent-X")
38 : ly_symbol2scm ("axis-group-parent-Y"),
42 /* must be ordered, because Align_interface also uses
43 Axis_group_interface */
44 Pointer_group_interface::add_grob (me, ly_symbol2scm ("elements"), e);
48 Axis_group_interface::has_axis (Grob *me, Axis a)
50 SCM axes = me->get_property ("axes");
52 return (SCM_BOOL_F != scm_memq (scm_from_int (a), axes));
56 Axis_group_interface::relative_group_extent (vector<Grob*> const &elts,
60 for (vsize i = 0; i < elts.size (); i++)
63 Interval dims = se->extent (common, a);
64 if (!dims.is_empty ())
71 Axis_group_interface::cached_pure_height (Grob *me,
72 vector<Grob*> const &elts,
76 Paper_score *ps = get_root_system (me)->paper_score ();
77 vector<vsize> breaks = ps->get_break_indices ();
78 vector<Grob*> cols = ps->get_columns ();
79 vsize start_index = VPOS;
80 vsize end_index = VPOS;
82 for (vsize i = 0; i < breaks.size (); i++)
84 int r = Paper_column::get_rank (cols[breaks[i]]);
91 if (start_index == VPOS || end_index == VPOS)
93 programming_error (_ ("tried to calculate pure-height at a non-breakpoint"));
94 return Interval (0, 0);
97 SCM extents = me->get_property ("cached-pure-extents");
98 if (!scm_is_vector (extents))
100 extents = scm_c_make_vector (breaks.size () - 1, SCM_EOL);
101 for (vsize i = 0; i < breaks.size () - 1; i++)
103 int st = Paper_column::get_rank (cols[breaks[i]]);
104 int ed = Paper_column::get_rank (cols[breaks[i+1]]);
105 Interval iv = relative_pure_height (me, elts, common, st, ed, false);
106 scm_vector_set_x (extents, scm_from_int (i), ly_interval2scm (iv));
108 me->set_property ("cached-pure-extents", extents);
112 for (vsize i = start_index; i < end_index; i++)
113 ext.unite (ly_scm2interval (scm_c_vector_ref (extents, i)));
118 Axis_group_interface::relative_pure_height (Grob *me,
119 vector<Grob*> const &elts,
124 /* It saves a _lot_ of time if we assume a VerticalAxisGroup is additive
125 (ie. height (i, k) = height (i, j) + height (j, k) for all i <= j <= k).
126 Unfortunately, it isn't always true, particularly if there is a
127 VerticalAlignment somewhere in the descendants.
129 Apart from PianoStaff, which has a fixed VerticalAlignment so it doesn't
130 count, the only VerticalAlignment comes from Score. This makes it
131 reasonably safe to assume that if our parent is a VerticalAlignment,
132 we can assume additivity and cache things nicely. */
133 Grob *p = me->get_parent (Y_AXIS);
134 if (use_cache && p && Align_interface::has_interface (p))
135 return Axis_group_interface::cached_pure_height (me, elts, common, start, end);
139 for (vsize i = 0; i < elts.size (); i++)
141 Interval_t<int> rank_span = elts[i]->spanned_rank_iv ();
142 Item *it = dynamic_cast<Item*> (elts[i]);
143 if (rank_span[LEFT] <= end && rank_span[RIGHT] >= start && (!it || it->pure_is_visible (start, end)))
145 Interval dims = elts[i]->pure_height (common, start, end);
146 if (!dims.is_empty ())
153 MAKE_SCHEME_CALLBACK (Axis_group_interface, width, 1);
155 Axis_group_interface::width (SCM smob)
157 Grob *me = unsmob_grob (smob);
158 return generic_group_extent (me, X_AXIS);
161 MAKE_SCHEME_CALLBACK (Axis_group_interface, height, 1);
163 Axis_group_interface::height (SCM smob)
165 Grob *me = unsmob_grob (smob);
166 return generic_group_extent (me, Y_AXIS);
169 MAKE_SCHEME_CALLBACK (Axis_group_interface, pure_height, 3);
171 Axis_group_interface::pure_height (SCM smob, SCM start_scm, SCM end_scm)
173 int start = robust_scm2int (start_scm, 0);
174 int end = robust_scm2int (end_scm, INT_MAX);
175 Grob *me = unsmob_grob (smob);
177 return pure_group_height (me, start, end);
181 Axis_group_interface::generic_group_extent (Grob *me, Axis a)
183 extract_grob_set (me, "elements", elts);
184 if (a == Y_AXIS && to_boolean (me->get_property ("skyline-spacing")))
185 skyline_spacing (me, elts);
186 Grob *common = common_refpoint_of_array (elts, me, a);
188 Real my_coord = me->relative_coordinate (common, a);
189 Interval r (relative_group_extent (elts, common, a));
191 return ly_interval2scm (r - my_coord);
195 Axis_group_interface::pure_group_height (Grob *me, int start, int end)
197 Grob *common = unsmob_grob (me->get_object ("common-refpoint-of-elements"));
201 extract_grob_set (me, "elements", elts);
203 vector<Grob*> relevant_elts;
204 SCM is_relevant = ly_lily_module_constant ("pure-relevant");
206 for (vsize i = 0; i < elts.size (); i++)
208 if (to_boolean (scm_apply_1 (is_relevant, elts[i]->self_scm (), SCM_EOL)))
209 relevant_elts.push_back (elts[i]);
211 Item *it = dynamic_cast<Item*> (elts[i]);
216 Item *piece = it->find_prebroken_piece (d);
217 if (piece && to_boolean (scm_apply_1 (is_relevant, piece->self_scm (), SCM_EOL)))
218 relevant_elts.push_back (piece);
220 while (flip (&d) != LEFT);
223 common = common_refpoint_of_array (relevant_elts, me, Y_AXIS);
224 me->set_object ("common-refpoint-of-elements", common->self_scm ());
226 SCM ga_scm = Grob_array::make_array ();
227 Grob_array *ga = unsmob_grob_array (ga_scm);
228 ga->set_array (relevant_elts);
229 me->set_object ("pure-relevant-elements", ga_scm);
232 extract_grob_set (me, "pure-relevant-elements", elts);
233 Real my_coord = me->relative_coordinate (common, Y_AXIS);
234 Interval r (relative_pure_height (me, elts, common, start, end, true));
236 return ly_interval2scm (r - my_coord);
240 Axis_group_interface::get_children (Grob *me, vector<Grob*> *found)
242 found->push_back (me);
244 if (!has_interface (me))
247 extract_grob_set (me, "elements", elements);
248 for (vsize i = 0; i < elements.size (); i++)
250 Grob *e = elements[i];
251 Axis_group_interface::get_children (e, found);
256 staff_priority_less (Grob * const &g1, Grob * const &g2)
258 int priority_1 = robust_scm2int (g1->get_property ("outside-staff-priority"), INT_MIN);
259 int priority_2 = robust_scm2int (g2->get_property ("outside-staff-priority"), INT_MIN);
261 if (priority_1 < priority_2)
263 else if (priority_1 > priority_2)
266 /* if there is no preference in staff priority, choose the one with the lower rank */
267 int rank_1 = g1->spanned_rank_iv ()[LEFT];
268 int rank_2 = g2->spanned_rank_iv ()[LEFT];
269 return rank_1 < rank_2;
273 Axis_group_interface::skyline_spacing (Grob *me, vector<Grob*> elements)
275 vector_sort (elements, staff_priority_less);
276 Grob *x_common = common_refpoint_of_array (elements, me, X_AXIS);
277 Grob *y_common = common_refpoint_of_array (elements, me, Y_AXIS);
282 for (i = 0; i < elements.size ()
283 && !scm_is_number (elements[i]->get_property ("outside-staff-priority")); i++)
284 boxes.push_back (Box (elements[i]->extent (x_common, X_AXIS),
285 elements[i]->extent (y_common, Y_AXIS)));
288 Drul_array<Skyline> skylines (Skyline (boxes, X_AXIS, DOWN),
289 Skyline (boxes, X_AXIS, UP));
290 for (; i < elements.size (); i++)
292 Direction dir = get_grob_direction (elements[i]);
295 warning (_ ("an outside-staff object should have a direction"));
299 Box b (elements[i]->extent (x_common, X_AXIS),
300 elements[i]->extent (y_common, Y_AXIS));
303 Skyline other = Skyline (boxes, X_AXIS, -dir);
304 Real dist = skylines[dir].distance (other);
308 b.translate (Offset (0, dir*dist));
309 elements[i]->translate_axis (dir*dist, Y_AXIS);
311 skylines[dir].insert (b, X_AXIS);
315 ADD_INTERFACE (Axis_group_interface,
317 "An object that groups other layout objects.",
322 "common-refpoint-of-elements "
323 "pure-relevant-elements "
325 "cached-pure-extents "