2 slur.cc -- implement Slur
4 source file of the GNU LilyPond music typesetter
6 (c) 1996--2000 Han-Wen Nienhuys <hanwen@cs.uu.nl>
7 Jan Nieuwenhuizen <janneke@gnu.org>
12 * fix broken interstaff slurs
13 * begin and end should be treated as a/acknowledge Scripts.
14 * broken slur should have uniform trend
15 * smart changing of endings
16 * smart changing of (Y-?)offsets to avoid ugly beziers
20 #include "directional-element-interface.hh"
21 #include "group-interface.hh"
24 #include "paper-def.hh"
25 #include "note-column.hh"
27 #include "paper-column.hh"
28 #include "molecule.hh"
30 #include "slur-bezier-bow.hh"
32 #include "group-interface.hh"
33 #include "staff-symbol-referencer.hh"
38 set_elt_property ("attachment", gh_cons (SCM_BOOL_F, SCM_BOOL_F));
39 set_elt_property ("note-columns", SCM_EOL);
40 set_elt_property ("control-points", SCM_EOL);
44 Slur::add_column (Note_column*n)
46 if (!gh_pair_p (n->get_elt_property ("note-heads")))
47 warning (_ ("Putting slur over rest. Ignoring."));
50 Pointer_group_interface (this, "note-columns").add_element (n);
54 add_bound_item (this, n);
58 Slur::de_uglyfy (Slur_bezier_bow* bb, Real default_height)
60 Real length = bb->curve_.control_[3][X_AXIS] ;
61 Real ff = bb->fit_factor ();
62 for (int i = 1; i < 3; i++)
64 Real ind = abs (bb->curve_.control_[(i-1)*3][X_AXIS]
65 - bb->curve_.control_[i][X_AXIS]) / length;
66 Real h = bb->curve_.control_[i][Y_AXIS] * ff / length;
68 Real f = default_height / length;
69 Real c1 = paper_l ()->get_var ("bezier_control1");
70 Real c2 = paper_l ()->get_var ("bezier_control2");
71 Real c3 = paper_l ()->get_var ("bezier_control3");
76 else if (h > c2 + c3 * ind)
81 bb->curve_.control_[i][Y_AXIS] = h * length;
84 bb->curve_.assert_sanity ();
88 Slur::get_default_dir () const
90 Link_array<Note_column> encompass_arr =
91 Pointer_group_interface__extract_elements (this, (Note_column*)0, "note-columns");
94 for (int i=0; i < encompass_arr.size (); i ++)
96 if (encompass_arr[i]->dir () < 0)
110 Slur::encompass_offset (Score_element* col,
111 Score_element **common) const
114 Score_element* stem_l = unsmob_element (col->get_elt_property ("stem"));
116 Direction dir = Directional_element_interface (this).get ();
120 warning (_ ("Slur over rest?"));
121 o[X_AXIS] = col->relative_coordinate (common[X_AXIS], X_AXIS);
122 o[Y_AXIS] = col->relative_coordinate (common[Y_AXIS], Y_AXIS);
125 Direction stem_dir = Directional_element_interface (stem_l).get ();
126 o[X_AXIS] = stem_l->relative_coordinate (0, X_AXIS);
129 Simply set x to middle of notehead
132 o[X_AXIS] -= 0.5 * stem_dir * col->extent (X_AXIS).length ();
134 if ((stem_dir == dir)
135 && !stem_l->extent (Y_AXIS).empty_b ())
137 o[Y_AXIS] = stem_l->relative_coordinate (common[Y_AXIS], Y_AXIS); // iuhg
141 o[Y_AXIS] = col->relative_coordinate (common[Y_AXIS], Y_AXIS); // ugh
145 leave a gap: slur mustn't touch head/stem
147 o[Y_AXIS] += dir * paper_l ()->get_var ("slur_y_free");
151 MAKE_SCHEME_CALLBACK(Slur,after_line_breaking);
154 Slur::after_line_breaking (SCM smob)
156 Score_element *me = unsmob_element (smob);
157 Slur * sl = dynamic_cast<Slur*>(me);
158 sl->set_extremities ();
159 sl->set_control_points ();
160 return SCM_UNDEFINED;
164 Slur::set_extremities ()
166 if (!Directional_element_interface (this).get ())
167 Directional_element_interface (this).set (get_default_dir ());
169 Direction dir = LEFT;
172 if (!gh_symbol_p (index_cell (get_elt_property ("attachment"), dir)))
175 // for (SCM s = get_elt_property ("slur-extremity-rules"); s != SCM_EOL; s = gh_cdr (s))
176 for (SCM s = scm_eval (ly_symbol2scm ("slur-extremity-rules"));
177 s != SCM_EOL; s = gh_cdr (s))
179 SCM r = gh_call2 (gh_caar (s), this->self_scm_,
180 gh_int2scm ((int)dir));
183 index_set_cell (get_elt_property ("attachment"), dir,
190 while (flip (&dir) != LEFT);
194 Slur::get_attachment (Direction dir,
195 Score_element **common) const
197 SCM s = get_elt_property ("attachment");
198 SCM a = dir == LEFT ? gh_car (s) : gh_cdr (s);
199 String str = ly_symbol2string (a);
200 Real ss = Staff_symbol_referencer::staff_space ((Score_element*)this);
205 if (Note_column* n = dynamic_cast<Note_column*> (get_bound (dir)))
209 Score_element*st = n->stem_l();
212 o = Offset (0, Stem::chord_start_f (st ));
214 Default position is centered in X, on outer side of head Y
216 o += Offset (0.5 * n->extent (X_AXIS).length (),
217 0.5 * ss * Directional_element_interface (this).get ());
219 else if (str == "alongside-stem")
221 o = Offset (0, Stem::chord_start_f (st ));
223 Default position is on stem X, on outer side of head Y
225 o += Offset (n->extent (X_AXIS).length ()
226 * (1 + Stem::get_direction (st )),
227 0.5 * ss * Directional_element_interface (this).get ());
229 else if (str == "stem")
231 o = Offset (0, Stem::stem_end_position (st ) * hs);
233 Default position is on stem X, at stem end Y
236 (n->extent (X_AXIS).length ()
237 - st->extent (X_AXIS).length ())
238 * (1 + Stem::get_direction (st )),
241 else if (str == "loose-end")
243 SCM other_a = dir == LEFT ? gh_cdr (s) : gh_car (s);
244 if (ly_symbol2string (other_a) != "loose-end")
246 o = Offset (0, get_attachment (-dir, common)[Y_AXIS]);
253 gh_int2scm (Stem::get_direction (st ) * dir),
254 gh_int2scm (Directional_element_interface (this).get () * dir),
256 scm_eval (ly_symbol2scm ("slur-extremity-offset-alist")));
260 o += ly_scm2offset (gh_cdr (l)) * ss * dir;
267 What if get_bound () is not a note-column?
269 if (str != "loose-end"
270 && get_bound (dir)->common_refpoint (common[Y_AXIS], Y_AXIS) == common[Y_AXIS])
272 o[Y_AXIS] += get_bound (dir)->relative_coordinate (common[Y_AXIS], Y_AXIS)
273 - relative_coordinate (common[Y_AXIS], Y_AXIS);
279 Slur::get_encompass_offset_arr () const
281 SCM eltlist = get_elt_property ("note-columns");
282 Score_element *common[] = {common_refpoint (eltlist,X_AXIS),
283 common_refpoint (eltlist,Y_AXIS)};
286 common[X_AXIS] = common[X_AXIS]->common_refpoint (get_bound (RIGHT), X_AXIS);
287 common[X_AXIS] = common[X_AXIS]->common_refpoint (get_bound (LEFT), X_AXIS);
289 Link_array<Score_element> encompass_arr;
290 while (gh_pair_p (eltlist))
292 encompass_arr.push (unsmob_element (gh_car (eltlist)));
293 eltlist =gh_cdr (eltlist);
295 encompass_arr.reverse ();
298 Array<Offset> offset_arr;
300 Offset origin (relative_coordinate (common[X_AXIS], X_AXIS),
301 relative_coordinate (common[Y_AXIS], Y_AXIS));
304 int last = encompass_arr.size () - 2;
306 offset_arr.push (get_attachment (LEFT, common));
312 if (encompass_arr[0] != get_bound (LEFT))
317 offset_arr[0][Y_AXIS] -=
318 encompass_arr[0]->relative_coordinate (common[Y_AXIS], Y_AXIS)
319 - relative_coordinate (common[Y_AXIS], Y_AXIS);
325 if (encompass_arr.top () != get_bound (RIGHT))
330 for (int i = first; i <= last; i++)
332 Offset o (encompass_offset (encompass_arr[i], common));
333 offset_arr.push (o - origin);
336 offset_arr.push (Offset (spanner_length (), 0) + get_attachment (RIGHT,common));
338 if (encompass_arr[0] != get_bound (LEFT))
340 offset_arr.top ()[Y_AXIS] -= encompass_arr.top ()->relative_coordinate (common[Y_AXIS], Y_AXIS)
341 - relative_coordinate (common[Y_AXIS], Y_AXIS);
349 Slur::get_rods () const
354 r.item_l_drul_[LEFT] = get_bound (LEFT);
355 r.item_l_drul_[RIGHT] = get_bound (RIGHT);
356 r.distance_f_ = paper_l ()->get_var ("slur_x_minimum");
364 Ugh should have dash-length + dash-period
366 MAKE_SCHEME_CALLBACK(Slur,brew_molecule);
368 Slur::brew_molecule (SCM smob)
370 Slur * me = dynamic_cast<Slur*> (unsmob_element (smob));
373 Real thick = me->paper_l ()->get_var ("slur_thickness");
374 Bezier one = me->get_curve ();
377 SCM d = me->get_elt_property ("dashed");
379 a = me->lookup_l ()->dashed_slur (one, thick, thick * gh_scm2double (d));
381 a = me->lookup_l ()->slur (one, Directional_element_interface (me).get () * thick, thick);
383 return a.create_scheme();
387 Slur::set_control_points ()
389 Slur_bezier_bow bb (get_encompass_offset_arr (),
390 Directional_element_interface (this).get ());
392 Real staff_space = Staff_symbol_referencer::staff_space (this);
393 Real h_inf = paper_l ()->get_var ("slur_height_limit_factor") * staff_space;
394 Real r_0 = paper_l ()->get_var ("slur_ratio");
396 bb.set_default_bezier (h_inf, r_0);
398 if (bb.fit_factor () > 1.0)
400 Real length = bb.curve_.control_[3][X_AXIS];
401 Real default_height = bb.get_default_height (h_inf, r_0, length);
402 bb.minimise_enclosed_area (paper_l(), default_height);
404 Real bff = paper_l ()->get_var ("slur_force_blowfit");
405 bb.curve_.control_[1][Y_AXIS] *= bff;
406 bb.curve_.control_[2][Y_AXIS] *= bff;
409 Real sb = paper_l ()->get_var ("slur_beautiful");
410 Real beautiful = length * default_height * sb;
411 Real area = bb.enclosed_area_f ();
414 Slurs that fit beautifully are not ugly
416 if (area > beautiful)
417 de_uglyfy (&bb, default_height);
420 Bezier b = bb.get_bezier ();
423 SCM controls = SCM_EOL;
425 controls = gh_cons ( ly_offset2scm (b.control_[i]), controls);
427 set_elt_property ("control-points", controls);
432 Slur::get_curve () const
437 if (!Directional_element_interface (this).get ()
438 || ! gh_symbol_p (index_cell (get_elt_property ("attachment"), LEFT)))
439 ((Slur*)this)->set_extremities ();
441 if (!gh_pair_p (get_elt_property ("control-points")))
442 ((Slur*)this)->set_control_points ();
445 for (SCM s= get_elt_property ("control-points"); s != SCM_EOL; s = gh_cdr (s))
447 b.control_[i] = ly_scm2offset (gh_car (s));
451 Array<Offset> enc (get_encompass_offset_arr ());
452 Direction dir = Directional_element_interface (this).get ();
454 Real x1 = enc[0][X_AXIS];
455 Real x2 = enc.top ()[X_AXIS];
458 for (int i=1; i < enc.size ()-1; i++)
460 Real x = enc[i][X_AXIS];
463 Real y = b.get_other_coordinate (X_AXIS, x);
464 off = off >? dir * (enc[i][Y_AXIS] - y);
467 b.translate (Offset (0, dir * off));