lily/tuplet-bracket.cc

   1 /*
   2   plet-spanner.cc -- implement Tuplet_bracket
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c)  1997--2003 Jan Nieuwenhuizen <janneke@gnu.org>
   7 */
   8
   9 /*
  10   TODO:
  11
  12   - tuplet bracket should probably be subject to the same rules as
  13   beam sloping/quanting.
  14
  15   - There is no support for kneed brackets, or nested brackets.
  16
  17   - number placement for parallel beams should be much more advanced:
  18     for sloped beams some extra horizontal offset must be introduced.
  19
  20   - number placement is usually done over the center note, not the
  21     graphical center.
  22
  23  */
  24
  25 #include <math.h>
  26
  27 #include "line-interface.hh"
  28 #include "beam.hh"
  29 #include "box.hh"
  30 #include "warn.hh"
  31 #include "font-interface.hh"
  32 #include "molecule.hh"
  33 #include "paper-def.hh"
  34 #include "text-item.hh"
  35 #include "tuplet-bracket.hh"
  36 #include "stem.hh"
  37 #include "note-column.hh"
  38 #include "group-interface.hh"
  39 #include "directional-element-interface.hh"
  40 #include "spanner.hh"
  41 #include "staff-symbol-referencer.hh"
  42 #include "lookup.hh"
  43
  44
  45 static Grob*
  46 get_x_bound_grob (Grob *g, Direction my_dir)
  47 {
  48   if (Note_column::get_stem (g)
  49       && Note_column::dir (g) == my_dir)
  50     {
  51       g = Note_column::get_stem (g);
  52     }
  53   return g;
  54 }
  55
  56
  57
  58 Grob*
  59 Tuplet_bracket::parallel_beam (Grob *me, Link_array<Grob> const &cols, bool *equally_long)
  60 {
  61   /*
  62     ugh: code dup.
  63   */
  64   Grob *s1 = Note_column::get_stem (cols[0]);
  65   Grob *s2 = Note_column::get_stem (cols.top());
  66
  67   Grob*b1 = s1 ? Stem::get_beam (s1) : 0;
  68   Grob*b2 = s2 ? Stem::get_beam (s2) : 0;
  69
  70   Spanner*sp = dynamic_cast<Spanner*> (me);
  71
  72   *equally_long= false;
  73   if (! (b1 && (b1 == b2) && !sp->broken_b()))
  74       return 0;
  75
  76   Link_array<Grob> beam_stems = Pointer_group_interface__extract_grobs
  77     (b1, (Grob*)0, "stems");
  78
  79   if (beam_stems.size() == 0)
  80     {
  81       programming_error ("Beam under tuplet bracket has no stems!");
  82       *equally_long = 0;
  83       return 0;
  84     }
  85
  86   *equally_long = (beam_stems[0] == s1 && beam_stems.top() == s2);
  87   return b1;
  88 }
  89
  90
  91 /*
  92   TODO:
  93
  94   in the case that there is no bracket, but there is a (single) beam,
  95   follow beam precisely for determining tuplet number location.
  96
  97  */
  98 MAKE_SCHEME_CALLBACK (Tuplet_bracket,brew_molecule,1);
  99 SCM
 100 Tuplet_bracket::brew_molecule (SCM smob)
 101 {
 102   Grob *me= unsmob_grob (smob);
 103   Molecule  mol;
 104   Link_array<Grob> columns=
 105     Pointer_group_interface__extract_grobs (me, (Grob*)0, "note-columns");
 106
 107   if (!columns.size ())
 108     return mol.smobbed_copy ();
 109
 110
 111
 112   {
 113     SCM lp = me->get_grob_property ("left-position");
 114     SCM rp = me->get_grob_property ("right-position");
 115
 116     if (!gh_number_p (rp) || !gh_number_p (lp))
 117       after_line_breaking (smob);
 118   }
 119
 120   Real ly = robust_scm2double (me->get_grob_property ("left-position"), 0);
 121   Real ry = robust_scm2double (me->get_grob_property ("right-position"), 0);
 122
 123   bool equally_long = false;
 124   Grob * par_beam = parallel_beam (me, columns, &equally_long);
 125
 126   Spanner*sp = dynamic_cast<Spanner*> (me);
 127
 128   bool bracket_visibility = !(par_beam && equally_long);
 129   bool number_visibility = true;
 130
 131   /*
 132     Fixme: the type of this prop is sucky.
 133    */
 134   SCM bracket = me->get_grob_property ("bracket-visibility");
 135   if (gh_boolean_p (bracket))
 136     {
 137       bracket_visibility = gh_scm2bool (bracket);
 138     }
 139   else if (bracket == ly_symbol2scm ("if-no-beam"))
 140     bracket_visibility = !par_beam;
 141
 142   SCM numb = me->get_grob_property ("number-visibility");
 143   if (gh_boolean_p (numb))
 144     {
 145       number_visibility = gh_scm2bool (numb);
 146     }
 147   else if (numb == ly_symbol2scm ("if-no-beam"))
 148     number_visibility = !par_beam;
 149
 150   Grob * commonx = columns[0]->common_refpoint (columns.top (),X_AXIS);
 151
 152   /*
 153     Tuplet brackets are normally not broken, but we shouldn't crash if
 154     they are.
 155    */
 156   commonx = commonx->common_refpoint (sp->get_bound(LEFT), X_AXIS);
 157   commonx = commonx->common_refpoint (sp->get_bound(RIGHT), X_AXIS);
 158
 159   Direction dir = get_grob_direction (me);
 160
 161   Grob * lgr = get_x_bound_grob (columns[0], dir);
 162   Grob * rgr = get_x_bound_grob (columns.top(), dir);
 163   Real x0 = lgr->extent (commonx,X_AXIS)[LEFT];
 164   Real x1 = rgr->extent (commonx,X_AXIS)[RIGHT];
 165
 166   Real w = x1 -x0;
 167
 168   SCM number = me->get_grob_property ("text");
 169
 170   Paper_def *pap = me->get_paper ();
 171   if (gh_string_p (number) && number_visibility)
 172     {
 173       SCM properties = Font_interface::font_alist_chain (me);
 174       SCM snum = Text_item::interpret_markup (pap->self_scm (), properties, number);
 175       Molecule num = *unsmob_molecule (snum);
 176       num.align_to (X_AXIS, CENTER);
 177       num.translate_axis (w/2, X_AXIS);
 178       num.align_to (Y_AXIS, CENTER);
 179
 180       num.translate_axis ((ry-ly)/2, Y_AXIS);
 181
 182       mol.add_molecule (num);
 183     }
 184
 185
 186   /*
 187     No bracket when it would be smaller than the number.
 188
 189     TODO: should use GAP in calculation too.
 190    */
 191   if (bracket_visibility && number_visibility
 192       && mol.extent (X_AXIS).length () > w)
 193     {
 194       bracket_visibility = false;
 195     }
 196
 197   if (bracket_visibility)
 198     {
 199       SCM gap = me->get_grob_property ("gap");
 200
 201       SCM fl = me->get_grob_property ("bracket-flare");
 202       SCM eh = me->get_grob_property ("edge-height");
 203       SCM sp = me->get_grob_property ("shorten-pair");
 204
 205       Direction d = LEFT;
 206       Drul_array<Real> height, flare, shorten;
 207       do {
 208         flare[d] =  height[d] = shorten[d] = 0.0;
 209         if (is_number_pair (fl))
 210           flare[d] +=  gh_scm2double (index_get_cell (fl, d));
 211         if (is_number_pair (eh))
 212           height[d] += gh_scm2double (index_get_cell (eh, d)) * - dir;
 213         if (is_number_pair (sp))
 214           shorten[d] +=  gh_scm2double (index_get_cell (sp, d));
 215       }
 216       while (flip (&d) != LEFT);
 217
 218       Molecule brack = make_bracket (me, Y_AXIS,
 219                                      Offset (w, ry - ly),
 220                                      height,
 221                                      gh_scm2double (gap),
 222                                      flare,
 223                                      shorten);
 224       mol.add_molecule (brack);
 225     }
 226
 227   mol.translate_axis (ly, Y_AXIS);
 228   mol.translate_axis (x0  - sp->get_bound (LEFT)->relative_coordinate (commonx,X_AXIS),X_AXIS);
 229   return mol.smobbed_copy ();
 230 }
 231
 232 /*
 233   should move to lookup?
 234
 235   TODO: this will fail for very short (shorter than the flare)
 236   brackets.
 237  */
 238 Molecule
 239 Tuplet_bracket::make_bracket (Grob *me, // for line properties.
 240                               Axis protusion_axis,
 241                               Offset dz,
 242                               Drul_array<Real> height,
 243                               Real gap,
 244                               Drul_array<Real> flare,
 245                               Drul_array<Real> shorten)
 246 {
 247   Drul_array<Offset> corners (Offset(0,0), dz);
 248
 249   Real length = dz.length ();
 250   Drul_array<Offset> gap_corners;
 251
 252
 253   Axis bracket_axis = other_axis (protusion_axis);
 254
 255   Drul_array<Offset> straight_corners = corners;
 256
 257   Direction d = LEFT;
 258   do {
 259     straight_corners[d] += - d * shorten[d] /length * dz;
 260     gap_corners[d] = (dz * 0.5) + d * gap / length * dz;
 261   } while (flip (&d) != LEFT);
 262
 263   Drul_array<Offset> flare_corners = straight_corners;
 264   do {
 265     flare_corners[d][bracket_axis] = straight_corners[d][bracket_axis];
 266     flare_corners[d][protusion_axis] += height[d];
 267     straight_corners[d][bracket_axis] += - d * flare[d];
 268   } while (flip (&d) != LEFT);
 269
 270   Molecule m;
 271   do {
 272     m.add_molecule (Line_interface::line (me, straight_corners[d],
 273                                                  gap_corners[d]));
 274
 275     m.add_molecule (Line_interface::line (me,  straight_corners[d],
 276                                                  flare_corners[d]));
 277   } while (flip (&d) != LEFT);
 278
 279   return m;
 280 }
 281
 282
 283 /*
 284   use first -> last note for slope, and then correct for disturbing
 285   notes in between.  */
 286 void
 287 Tuplet_bracket::calc_position_and_height (Grob*me,Real *offset, Real * dy)
 288 {
 289   Link_array<Grob> columns=
 290     Pointer_group_interface__extract_grobs (me, (Grob*)0, "note-columns");
 291
 292
 293   SCM cols = me->get_grob_property ("note-columns");
 294   Grob * commony = common_refpoint_of_list (cols, me, Y_AXIS);
 295   Grob * commonx = common_refpoint_of_list (cols, me, X_AXIS);
 296
 297   Interval staff;
 298
 299   if (Grob * st = Staff_symbol_referencer::get_staff_symbol (me))
 300     staff = st->extent (commony, Y_AXIS);
 301
 302   Direction dir = get_grob_direction (me);
 303
 304   /*
 305     Use outer non-rest columns to determine slope
 306    */
 307   int l = 0;
 308   while (l <columns.size () && Note_column::rest_b (columns[l]))
 309     l ++;
 310
 311   int r = columns.size ()- 1;
 312   while (r >= l && Note_column::rest_b (columns[r]))
 313     r--;
 314
 315   if (l < r)
 316     {
 317       Interval rv =columns[r]->extent (commony, Y_AXIS);
 318       Interval lv =columns[l]->extent (commony, Y_AXIS);
 319       rv.unite (staff);
 320       lv.unite (staff);
 321
 322       *dy =  rv[dir] - lv[dir];
 323     }
 324   else
 325     * dy = 0;
 326
 327
 328   *offset = - dir * infinity_f;
 329
 330   if (!columns.size ())
 331     return;
 332
 333
 334
 335   Grob * lgr = get_x_bound_grob (columns[0], dir);
 336   Grob * rgr = get_x_bound_grob (columns.top(), dir);
 337   Real x0 = lgr->extent (commonx,X_AXIS)[LEFT];
 338   Real x1 = rgr->extent (commonx,X_AXIS)[RIGHT];
 339
 340
 341   /*
 342     Slope.
 343   */
 344   Real factor = columns.size () > 1 ? 1/ (x1 - x0) : 1.0;
 345
 346   for (int i = 0; i < columns.size ();  i++)
 347     {
 348       Interval note_ext =columns[i]->extent (commony, Y_AXIS);
 349       note_ext.unite (staff);
 350       Real notey = note_ext[dir] - me->relative_coordinate (commony, Y_AXIS);
 351
 352       Real x = columns[i]->relative_coordinate (commonx, X_AXIS) - x0;
 353       Real tuplety =  *dy * x * factor;
 354
 355       if (notey * dir > (*offset + tuplety) * dir)
 356         *offset = notey - tuplety;
 357     }
 358
 359   // padding
 360   *offset +=  gh_scm2double (me->get_grob_property ("padding")) *dir;
 361
 362
 363   /*
 364     horizontal brackets should not collide with staff lines.
 365
 366    */
 367   Real ss= Staff_symbol_referencer::staff_space (me);
 368   if (*dy == 0 && fabs (*offset) <  ss * Staff_symbol_referencer::staff_radius (me))
 369     {
 370       // quantize, then do collision check.
 371       *offset *= 2 / ss;
 372
 373       *offset = rint (*offset);
 374       if (Staff_symbol_referencer::on_staffline (me, (int) rint (*offset)))
 375         *offset += dir;
 376
 377       *offset *= 0.5 * ss;
 378     }
 379
 380 }
 381
 382 /*
 383   use first -> last note for slope,
 384 */
 385 void
 386 Tuplet_bracket::calc_dy (Grob*me,Real * dy)
 387 {
 388   Link_array<Grob> columns=
 389     Pointer_group_interface__extract_grobs (me, (Grob*)0, "note-columns");
 390
 391   /*
 392     ugh. refps.
 393    */
 394   Direction d = get_grob_direction (me);
 395   *dy = columns.top ()->extent (columns.top (), Y_AXIS) [d]
 396     - columns[0]->extent (columns[0], Y_AXIS) [d];
 397 }
 398
 399
 400 /*
 401   We depend on the beams if there are any.
 402  */
 403 MAKE_SCHEME_CALLBACK (Tuplet_bracket,before_line_breaking,1);
 404 SCM
 405 Tuplet_bracket::before_line_breaking (SCM smob)
 406 {
 407   Grob *me = unsmob_grob (smob);
 408   Link_array<Grob> columns=
 409     Pointer_group_interface__extract_grobs (me, (Grob*)0, "note-columns");
 410
 411
 412   for (int i = columns.size(); i--;)
 413     {
 414       Grob * s =Note_column::get_stem (columns[i]);
 415       Grob * b = s ? Stem::get_beam (s): 0;
 416       if (b)
 417         me->add_dependency (b);
 418     }
 419   return SCM_UNDEFINED;
 420 }
 421
 422 MAKE_SCHEME_CALLBACK (Tuplet_bracket,after_line_breaking,1);
 423
 424 SCM
 425 Tuplet_bracket::after_line_breaking (SCM smob)
 426 {
 427   Grob * me = unsmob_grob (smob);
 428   Link_array<Grob> columns=
 429     Pointer_group_interface__extract_grobs (me, (Grob*)0, "note-columns");
 430
 431   if (!columns.size ())
 432     {
 433       me->suicide ();
 434       return SCM_UNSPECIFIED;
 435     }
 436   if (dynamic_cast<Spanner*> (me)->broken_b ())
 437     {
 438       me->warning (_("Killing tuplet bracket across linebreak."));
 439       me->suicide();
 440       return SCM_UNSPECIFIED;
 441     }
 442
 443   Direction dir = get_grob_direction (me);
 444   if (!dir)
 445     {
 446       dir = Tuplet_bracket::get_default_dir (me);
 447       set_grob_direction (me, dir);
 448     }
 449
 450   bool equally_long = false;
 451   Grob * par_beam = parallel_beam (me, columns, &equally_long);
 452
 453   /*
 454     We follow the beam only if there is one, and we are next to it.
 455    */
 456   Real dy, offset;
 457   if (!par_beam
 458       || get_grob_direction (par_beam) != dir)
 459     {
 460       calc_position_and_height (me,&offset,&dy);
 461     }
 462   else
 463     {
 464       SCM ps =  par_beam->get_grob_property ("positions");
 465
 466       Real lp = gh_scm2double (gh_car (ps));
 467       Real rp = gh_scm2double (gh_cdr (ps));
 468
 469       /*
 470         duh. magic.
 471        */
 472       offset = lp + dir * (0.5 + gh_scm2double (me->get_grob_property ("padding")));
 473       dy = rp- lp;
 474     }
 475
 476
 477   SCM lp =  me->get_grob_property ("left-position");
 478   SCM rp = me->get_grob_property ("right-position");
 479
 480   if (gh_number_p (lp) && !gh_number_p (rp))
 481     {
 482       rp = gh_double2scm (gh_scm2double (lp) + dy);
 483     }
 484   else if (gh_number_p (rp) && !gh_number_p (lp))
 485     {
 486       lp = gh_double2scm (gh_scm2double (rp) - dy);
 487     }
 488   else if (!gh_number_p (rp) && !gh_number_p (lp))
 489     {
 490       lp = gh_double2scm (offset);
 491       rp = gh_double2scm (offset +dy);
 492     }
 493
 494   me->set_grob_property ("left-position", lp);
 495   me->set_grob_property ("right-position", rp);
 496
 497   return SCM_UNSPECIFIED;
 498 }
 499
 500
 501 /*
 502   similar to slur.
 503  */
 504 Direction
 505 Tuplet_bracket::get_default_dir (Grob*me)
 506 {
 507   Direction d = UP;
 508   for (SCM s = me->get_grob_property ("note-columns"); gh_pair_p (s); s = ly_cdr (s))
 509     {
 510       Grob * nc = unsmob_grob (ly_car (s));
 511       if (Note_column::dir (nc) < 0)
 512         {
 513           d = DOWN;
 514           break;
 515         }
 516     }
 517   return d;
 518 }
 519
 520 void
 521 Tuplet_bracket::add_column (Grob*me, Item*n)
 522 {
 523   Pointer_group_interface::add_grob (me, ly_symbol2scm ("note-columns"), n);
 524   me->add_dependency (n);
 525
 526   add_bound_item (dynamic_cast<Spanner*> (me), n);
 527 }
 528
 529
 530
 531
 532
 533
 534 ADD_INTERFACE (Tuplet_bracket,"tuplet-bracket-interface",
 535   "A bracket with a number in the middle, used for tuplets.",
 536   "note-columns bracket-flare edge-height shorten-pair padding gap left-position right-position bracket-visibility number-visibility thickness direction");
 537