lily/tie.cc

   1 /*
   2   tie.cc -- implement Tie
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c)  1997--2000 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   7 */
   8 #include <math.h>
   9
  10 #include "spanner.hh"
  11 #include "lookup.hh"
  12 #include "paper-def.hh"
  13 #include "tie.hh"
  14 #include "rhythmic-head.hh"
  15 #include "bezier.hh"
  16 #include "paper-column.hh"
  17 #include "debug.hh"
  18 #include "staff-symbol-referencer.hh"
  19 #include "directional-element-interface.hh"
  20 #include "molecule.hh"
  21 #include "bezier-bow.hh"
  22 #include "stem.hh"
  23 #include "note-head.hh"
  24
  25 /*
  26   tie: Connect two noteheads.
  27
  28   What if we have
  29
  30   c4 ~ \clef bass ; c4 or
  31
  32   c4 \staffchange c4
  33
  34   do we have non-horizontal ties then?
  35   */
  36
  37
  38 void
  39 Tie::set_head (Score_element*me,Direction d, Item * head_l)
  40 {
  41   assert (!head (me,d));
  42   index_set_cell (me->get_elt_property ("heads"), d, head_l->self_scm ());
  43
  44   dynamic_cast<Spanner*> (me)->set_bound (d, head_l);
  45   me->add_dependency (head_l);
  46 }
  47
  48 void
  49 Tie::set_interface (Score_element*me)
  50 {
  51   me->set_elt_property ("heads", gh_cons (SCM_EOL, SCM_EOL));
  52   me->set_interface (ly_symbol2scm ("tie-interface"));
  53 }
  54
  55 bool
  56 Tie::has_interface (Score_element*me)
  57 {
  58   return me->has_interface (ly_symbol2scm ("tie-interface"));
  59 }
  60
  61 Score_element*
  62 Tie::head (Score_element*me, Direction d)
  63 {
  64   SCM c = me->get_elt_property ("heads");
  65   c = index_cell (c, d);
  66
  67   return unsmob_element (c);
  68 }
  69
  70 Real
  71 Tie::position_f (Score_element*me)
  72 {
  73   Direction d = head (me,LEFT) ? LEFT:RIGHT;
  74   return Staff_symbol_referencer::position_f (head (me,d));
  75 }
  76
  77
  78 /*
  79   Default:  Put the tie oppositie of the stem [Wanske p231]
  80
  81   In case of chords: Tie_column takes over
  82
  83   The direction of the Tie is more complicated (See [Ross] p136 and
  84   further).
  85 */
  86 Direction
  87 Tie::get_default_dir (Score_element*me)
  88 {
  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;
  91
  92   if (sl && sr)
  93     {
  94       if (Directional_element_interface::get (sl) == UP
  95           && Directional_element_interface::get (sr) == UP)
  96         return DOWN;
  97     }
  98   else if (sl || sr)
  99     {
 100       Item *s = sl ? sl : sr;
 101       return - Directional_element_interface::get (s);
 102     }
 103
 104
 105   return UP;
 106 }
 107
 108
 109 SCM
 110 Tie::get_control_points (SCM smob)
 111 {
 112   Spanner*me = dynamic_cast<Spanner*> (unsmob_element (smob));
 113   Direction headdir = CENTER;
 114   if (head (me,LEFT))
 115     headdir = LEFT;
 116   else if (head(me,RIGHT))
 117     headdir = RIGHT;
 118   else
 119     {
 120       programming_error ("Tie without heads.");
 121       me->suicide ();
 122       return SCM_UNSPECIFIED;
 123     }
 124
 125   if (!Directional_element_interface::get (me))
 126     Directional_element_interface::set (me, Tie::get_default_dir (me));
 127
 128   Real staff_space = Staff_symbol_referencer::staff_space (me);
 129
 130   Real x_gap_f = me->paper_l ()->get_var ("tie_x_gap");
 131
 132   Score_element* commonx = me->common_refpoint (me->get_bound (LEFT), X_AXIS);
 133   commonx = me->common_refpoint (me->get_bound (RIGHT), X_AXIS);
 134
 135   Score_element* l = me->get_bound (LEFT);
 136   Score_element* r = me->get_bound (RIGHT);
 137
 138   Real left_x;
 139   if (Note_head::has_interface (me->get_bound (LEFT)))
 140     left_x = l->extent (X_AXIS)[RIGHT] + x_gap_f;
 141   else
 142     left_x = l->extent (X_AXIS).length () / 2;
 143
 144   Real width;
 145   if (Note_head::has_interface (me->get_bound (LEFT))
 146       && Note_head::has_interface (me->get_bound (RIGHT)))
 147     {
 148       width = r->relative_coordinate (commonx, X_AXIS)
 149         + r->extent (X_AXIS)[LEFT]
 150         - l->relative_coordinate (commonx, X_AXIS)
 151         - l->extent (X_AXIS)[RIGHT]
 152         -2 * x_gap_f;
 153     }
 154   else
 155     {
 156       if (Note_head::has_interface (me->get_bound (LEFT)))
 157         width = r->relative_coordinate (commonx, X_AXIS)
 158           - l->relative_coordinate (commonx, X_AXIS)
 159           - l->extent (X_AXIS)[RIGHT]
 160           - 2 * x_gap_f;
 161       else
 162         width = r->relative_coordinate (commonx, X_AXIS)
 163           - l->extent (X_AXIS).length () / 2
 164           + r->extent (X_AXIS)[LEFT]
 165           - l->relative_coordinate (commonx, X_AXIS)
 166           - 2 * x_gap_f;
 167     }
 168
 169   Direction dir = Directional_element_interface::get(me);
 170
 171   Real h_inf = me->paper_l ()->get_var ("tie_height_limit_factor") * staff_space;
 172   Real r_0 = me->paper_l ()->get_var ("tie_ratio");
 173
 174
 175   Bezier b  = slur_shape (width, h_inf, r_0);
 176
 177   Offset leave_dir = b.control_[1] - b.control_[0];
 178
 179   Real dx = (head (me, headdir)->extent (X_AXIS).length () + x_gap_f)/2.0;
 180   Real max_gap = leave_dir[Y_AXIS] * dx / leave_dir[X_AXIS];
 181
 182   /*
 183     for small ties (t small) we want to start in the Y-center (so dy = 0), for
 184     large ties, the tie should appear to come from the center of the
 185     head, so dy = max_gap
 186
 187     maybe use a different formula?
 188
 189     TODO: what if 2 heads have different size.
 190
 191     TODO: for small ties, it is better to start over the heads
 192     iso. next to the heads.
 193   */
 194   Real t = (width / staff_space - 5.0); // ugh.
 195   Real dy = t > 0 ? max_gap * sqr (t / (1 + t)) : 0.0;
 196
 197   Real ypos = Tie::position_f (me) * staff_space/2 + dir * dy;
 198
 199   /*
 200     todo: prevent ending / staffline collision.
 201
 202     todo: tie / stem collision
 203    */
 204
 205   b = slur_shape(width,h_inf, r_0);
 206   b.scale (1, dir);
 207   b.translate (Offset (left_x, ypos));
 208
 209
 210   /*
 211     Avoid colliding of the horizontal part with stafflines.
 212
 213     should do me for slurs as well.
 214
 215    */
 216   Array<Real> horizontal (b.solve_derivative (Offset (1,0)));
 217   if (horizontal.size ())
 218     {
 219       /*
 220         ugh. Doesnt work for non-horizontal curves.
 221        */
 222       Real y = b.curve_point (horizontal[0])[Y_AXIS];
 223
 224       Real ry = rint (y/staff_space) * staff_space;
 225       Real diff = ry - y;
 226       Real newy = y;
 227       if (fabs (y) <= Staff_symbol_referencer::staff_radius (me)
 228           && fabs (diff) < me->paper_l ()->get_var ("tie_staffline_clearance"))
 229         {
 230           newy = ry - 0.5 * staff_space * sign (diff) ;
 231         }
 232
 233       Real y0 = b.control_ [0][Y_AXIS];
 234       b.control_[2][Y_AXIS] =
 235       b.control_[1][Y_AXIS] =
 236         (b.control_[1][Y_AXIS] - y0)  * ((newy - y0) / (y - y0)) + y0;
 237     }
 238   else
 239     programming_error ("Tie is nowhere horizontal");
 240
 241
 242
 243   SCM controls = SCM_EOL;
 244   for (int i= 4; i--;)
 245     controls = gh_cons ( ly_offset2scm (b.control_[i]), controls);
 246   return controls;
 247 }
 248
 249 MAKE_SCHEME_CALLBACK(Tie,set_spacing_rods);
 250
 251 /*
 252   TODO: set minimum distances for begin/end of line
 253  */
 254 SCM
 255 Tie::set_spacing_rods (SCM smob)
 256 {
 257   Score_element*me = unsmob_element (smob);
 258   Spanner*sp = dynamic_cast<Spanner*> (me);
 259   Rod r;
 260
 261   r.item_l_drul_ [LEFT]=sp->get_bound (LEFT);
 262   r.item_l_drul_ [RIGHT]=sp->get_bound (RIGHT);
 263
 264   r.distance_f_
 265     = gh_scm2double (me->get_elt_property ("minimum-length"))
 266     * me->paper_l ()->get_var ("staffspace");
 267   r.add_to_cols ();
 268   return SCM_UNSPECIFIED;
 269 }
 270
 271 MAKE_SCHEME_CALLBACK(Tie,brew_molecule);
 272 SCM
 273 Tie::brew_molecule (SCM smob)
 274 {
 275   Score_element*me = unsmob_element (smob);
 276
 277   SCM cp = me->get_elt_property ("control-points");
 278   if (cp == SCM_EOL)
 279     {
 280       cp = get_control_points (smob);
 281       me->set_elt_property ("control-points", cp);
 282     }
 283
 284   Real thick =
 285     gh_scm2double (me->get_elt_property ("thickness"))
 286     * me->paper_l ()->get_var ("stafflinethickness");
 287
 288   Bezier b;
 289   int i = 0;
 290   for (SCM s= cp; s != SCM_EOL; s = gh_cdr (s))
 291     {
 292       b.control_[i] = ly_scm2offset (gh_car (s));
 293       i++;
 294     }
 295
 296    Molecule a = me->lookup_l ()->slur (b, Directional_element_interface::get (me) * thick, thick);
 297
 298    return a.create_scheme ();
 299 }
 300
 301