2 tie.cc -- implement Tie
4 source file of the GNU LilyPond music typesetter
6 (c) 1997--2002 Han-Wen Nienhuys <hanwen@cs.uu.nl>
13 #include "paper-def.hh"
15 #include "rhythmic-head.hh"
17 #include "paper-column.hh"
19 #include "staff-symbol-referencer.hh"
20 #include "directional-element-interface.hh"
21 #include "molecule.hh"
22 #include "bezier-bow.hh"
24 #include "note-head.hh"
27 tie: Connect two noteheads.
31 c4 ~ \clef bass ; c4 or
35 do we have non-horizontal ties then?
40 Tie::set_head (Grob*me,Direction d, Item * head_l)
42 assert (!head (me,d));
43 index_set_cell (me->get_grob_property ("heads"), d, head_l->self_scm ());
45 dynamic_cast<Spanner*> (me)->set_bound (d, head_l);
46 me->add_dependency (head_l);
50 Tie::set_interface (Grob*me)
52 me->set_grob_property ("heads", gh_cons (SCM_EOL, SCM_EOL));
56 Tie::has_interface (Grob*me)
58 return me->has_interface (ly_symbol2scm ("tie-interface"));
62 Tie::head (Grob*me, Direction d)
64 SCM c = me->get_grob_property ("heads");
65 c = index_cell (c, d);
67 return unsmob_grob (c);
71 Tie::position_f (Grob*me)
73 Direction d = head (me,LEFT) ? LEFT:RIGHT;
74 return Staff_symbol_referencer::position_f (head (me,d));
79 Default: Put the tie oppositie of the stem [Wanske p231]
81 In case of chords: Tie_column takes over
83 The direction of the Tie is more complicated (See [Ross] p136 and
87 Tie::get_default_dir (Grob*me)
89 Item * sl = head (me,LEFT) ? Rhythmic_head::stem_l (head (me,LEFT)) :0;
90 Item * sr = head (me,RIGHT) ? Rhythmic_head::stem_l (head (me,RIGHT)) :0;
94 if (Directional_element_interface::get (sl) == UP
95 && Directional_element_interface::get (sr) == UP)
100 Item *s = sl ? sl : sr;
101 return - Directional_element_interface::get (s);
110 Tie::get_control_points (SCM smob)
112 Spanner*me = unsmob_spanner (smob);
113 Direction headdir = CENTER;
116 else if (head (me,RIGHT))
120 programming_error ("Tie without heads.");
122 return SCM_UNSPECIFIED;
125 if (!Directional_element_interface::get (me))
126 Directional_element_interface::set (me, Tie::get_default_dir (me));
128 Real staff_space = Staff_symbol_referencer::staff_space (me);
130 Real x_gap_f = gh_scm2double (me->get_grob_property ("x-gap"));
132 Grob* l = me->get_bound (LEFT);
133 Grob* r = me->get_bound (RIGHT);
135 Grob* commonx = me->common_refpoint (l, X_AXIS);
136 commonx = me->common_refpoint (r, X_AXIS);
141 this is a kludge: the tie has to be long enough to be
142 visible, but should not go through key sigs.
148 if (Note_head::has_interface (l))
149 left_x = l->extent (l, X_AXIS)[RIGHT] + x_gap_f;
151 left_x = l->extent (l, X_AXIS).linear_combination (lambda);
155 if (Note_head::has_interface (l) && Note_head::has_interface (r))
158 + r->extent (commonx,X_AXIS)[LEFT]
159 - l->extent (commonx, X_AXIS)[RIGHT]
164 if (Note_head::has_interface (l))
165 width = r->relative_coordinate (commonx, X_AXIS)
166 - l->extent (commonx, X_AXIS)[RIGHT]
170 - l->extent (commonx, X_AXIS).linear_combination (lambda)
171 + r->extent (commonx, X_AXIS)[LEFT]
175 Direction dir = Directional_element_interface::get (me);
177 SCM details = me->get_grob_property ("details");
179 SCM lim // groetjes aan de chirurgendochter.
180 = scm_assq (ly_symbol2scm ("height-limit"),details);
182 Real h_inf = gh_scm2double (ly_cdr (lim)) * staff_space;
183 Real r_0 = gh_scm2double (ly_cdr (scm_assq (ly_symbol2scm ("ratio"),details)));
185 Bezier b = slur_shape (width, h_inf, r_0);
188 I think this better, particularly for small ties. It always allows the user to move ties if
189 they seem in the wrong place
191 TODO: what if 2 heads have different size.
195 Real ypos = Tie::position_f (me) * staff_space/2
196 + dir * gh_scm2double (me->get_grob_property ("y-offset"));;
199 Make sure we don't start on a dots
201 if (Note_head::has_interface (l) && Rhythmic_head::dots_l (l))
203 Grob* dots = Rhythmic_head::dots_l(l);
204 if(fabs (staff_space * Staff_symbol_referencer::position_f (dots) /2
213 todo: prevent ending / staffline collision.
215 todo: tie / stem collision
218 b = slur_shape (width,h_inf, r_0);
220 b.translate (Offset (left_x, ypos));
224 Avoid colliding of the horizontal part with stafflines.
227 TODO: redo this, heuristic is half-baken, and ties often look ugly
230 TODO: doesn't work when on staff with even number of lines.
232 Array<Real> horizontal (b.solve_derivative (Offset (1,0)));
233 if (horizontal.size ())
236 ugh. Doesnt work for non-horizontal curves.
238 Real y = b.curve_point (horizontal[0])[Y_AXIS];
240 Real ry = rint (y/staff_space) * staff_space;
244 Real clear = staff_space * gh_scm2double (me->get_grob_property ("staffline-clearance"));
246 if (fabs (y) <= Staff_symbol_referencer::staff_radius (me)
247 && fabs (diff) < clear)
249 Real y1 = ry + clear;
250 Real y2 = ry - clear;
252 newy = (fabs (y1 - y) < fabs (y2 - y)) ? y1 : y2;
254 // newy = ry - 0.5 * staff_space * sign (diff) ;
257 we don't want horizontal ties
259 if (fabs (newy - b.control_[0][Y_AXIS]) < 1e-2)
261 newy = newy + dir * staff_space;
265 Real y0 = b.control_ [0][Y_AXIS];
266 b.control_[2][Y_AXIS] =
267 b.control_[1][Y_AXIS] =
268 (b.control_[1][Y_AXIS] - y0) * ((newy - y0) / (y - y0)) + y0;
271 programming_error ("Tie is nowhere horizontal");
275 SCM controls = SCM_EOL;
277 controls = gh_cons (ly_offset2scm (b.control_[i]), controls);
282 MAKE_SCHEME_CALLBACK (Tie,brew_molecule,1);
284 Tie::brew_molecule (SCM smob)
286 Grob*me = unsmob_grob (smob);
288 SCM cp = me->get_grob_property ("control-points");
291 cp = get_control_points (smob);
292 me->set_grob_property ("control-points", cp);
296 gh_scm2double (me->get_grob_property ("thickness"))
297 * me->paper_l ()->get_var ("stafflinethickness");
301 for (SCM s= cp; s != SCM_EOL; s = ly_cdr (s))
303 b.control_[i] = ly_scm2offset (ly_car (s));
307 Molecule a = Lookup::slur (b, Directional_element_interface::get (me) * thick, thick);
309 return a.smobbed_copy ();
314 ADD_INTERFACE (Tie,"tie-interface",
315 "A tie connecting two noteheads.
316 direction = Forced direction for all ties",
317 "y-offset staffline-clearance control-points heads details thickness x-gap direction minimum-length");