lily/slur.cc

   1 /*
   2   slur.cc -- implement external interface for Slur
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 1996--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
   7   Jan Nieuwenhuizen <janneke@gnu.org>
   8 */
   9
  10 #include "slur.hh"
  11
  12
  13 #include "beam.hh"
  14 #include "bezier.hh"
  15 #include "directional-element-interface.hh"
  16 #include "font-interface.hh"
  17 #include "pointer-group-interface.hh"
  18 #include "lookup.hh"
  19 #include "main.hh"              // DEBUG_SLUR_SCORING
  20 #include "note-column.hh"
  21 #include "output-def.hh"
  22 #include "spanner.hh"
  23 #include "staff-symbol-referencer.hh"
  24 #include "staff-symbol.hh"
  25 #include "stem.hh"
  26 #include "text-interface.hh"
  27 #include "warn.hh"
  28 #include "slur-scoring.hh"
  29
  30 #include "script-interface.hh"
  31
  32
  33
  34 MAKE_SCHEME_CALLBACK(Slur, calc_direction, 1)
  35 SCM
  36 Slur::calc_direction (SCM smob)
  37 {
  38   Grob *me = unsmob_grob (smob);
  39   extract_grob_set (me, "note-columns", encompasses);
  40
  41   if (encompasses.empty ())
  42     {
  43       me->suicide ();
  44       return SCM_BOOL_F;
  45     }
  46
  47   Direction d = DOWN;
  48   for (vsize i = 0; i < encompasses.size (); i++)
  49     {
  50       if (Note_column::dir (encompasses[i]) < 0)
  51         {
  52           d = UP;
  53           break;
  54         }
  55     }
  56   return scm_from_int (d);
  57 }
  58
  59 MAKE_SCHEME_CALLBACK (Slur, height, 1);
  60 SCM
  61 Slur::height (SCM smob)
  62 {
  63   Grob *me = unsmob_grob (smob);
  64
  65   // FIXME uncached
  66   Stencil *m = me->get_stencil ();
  67   return m ? ly_interval2scm (m->extent (Y_AXIS))
  68     : ly_interval2scm (Interval ());
  69 }
  70
  71 /*
  72   Ugh should have dash-length + dash-period
  73 */
  74 MAKE_SCHEME_CALLBACK (Slur, print, 1);
  75 SCM
  76 Slur::print (SCM smob)
  77 {
  78   Grob *me = unsmob_grob (smob);
  79   extract_grob_set (me, "note-columns", encompasses);
  80   if (encompasses.empty ())
  81     {
  82       me->suicide ();
  83       return SCM_EOL;
  84     }
  85
  86   Real staff_thick = Staff_symbol_referencer::line_thickness (me);
  87   Real base_thick = staff_thick
  88     * robust_scm2double (me->get_property ("thickness"), 1);
  89   Real line_thick = staff_thick
  90     * robust_scm2double (me->get_property ("line-thickness"), 1);
  91
  92   Bezier one = get_curve (me);
  93   Stencil a;
  94
  95   /*
  96     TODO: replace dashed with generic property.
  97   */
  98   SCM p = me->get_property ("dash-period");
  99   SCM f = me->get_property ("dash-fraction");
 100   if (scm_is_number (p) && scm_is_number (f))
 101     a = Lookup::dashed_slur (one, line_thick, robust_scm2double (p, 1.0),
 102                              robust_scm2double (f, 0));
 103   else
 104     a = Lookup::slur (one,
 105                       get_grob_direction (me) * base_thick,
 106                       line_thick);
 107
 108 #if DEBUG_SLUR_SCORING
 109   SCM quant_score = me->get_property ("quant-score");
 110
 111   if (to_boolean (me->layout ()
 112                   ->lookup_variable (ly_symbol2scm ("debug-slur-scoring")))
 113       && scm_is_string (quant_score))
 114     {
 115       string str;
 116       SCM properties = Font_interface::text_font_alist_chain (me);
 117
 118
 119       if (!scm_is_number (me->get_property ("font-size")))
 120         properties = scm_cons (scm_acons (ly_symbol2scm ("font-size"), scm_from_int (-6), SCM_EOL),
 121                              properties);
 122
 123       Stencil tm = *unsmob_stencil (Text_interface::interpret_markup
 124                                     (me->layout ()->self_scm (), properties,
 125                                      quant_score));
 126       a.add_at_edge (Y_AXIS, get_grob_direction (me), tm, 1.0, 0);
 127     }
 128 #endif
 129
 130   return a.smobbed_copy ();
 131 }
 132
 133 Bezier
 134 Slur::get_curve (Grob *me)
 135 {
 136   Bezier b;
 137   int i = 0;
 138   for (SCM s = me->get_property ("control-points"); s != SCM_EOL;
 139        s = scm_cdr (s))
 140     b.control_[i++] = ly_scm2offset (scm_car (s));
 141
 142   return b;
 143 }
 144
 145 void
 146 Slur::add_column (Grob *me, Grob *n)
 147 {
 148   Pointer_group_interface::add_grob (me, ly_symbol2scm ("note-columns"), n);
 149   add_bound_item (dynamic_cast<Spanner *> (me), dynamic_cast<Item *> (n));
 150 }
 151
 152 void
 153 Slur::add_extra_encompass (Grob *me, Grob *n)
 154 {
 155   Pointer_group_interface::add_grob (me, ly_symbol2scm ("encompass-objects"), n);
 156 }
 157
 158
 159 MAKE_SCHEME_CALLBACK (Slur, outside_slur_callback, 2);
 160 SCM
 161 Slur::outside_slur_callback (SCM grob, SCM offset_scm)
 162 {
 163   Grob *script = unsmob_grob (grob);
 164   Grob *slur = unsmob_grob (script->get_object ("slur"));
 165
 166   if (!slur)
 167     return offset_scm;
 168
 169   SCM avoid = script->get_property ("avoid-slur");
 170   if (avoid != ly_symbol2scm ("outside")
 171       && avoid != ly_symbol2scm ("around"))
 172     return offset_scm;
 173
 174   Direction dir = get_grob_direction (script);
 175   if (dir == CENTER)
 176     return offset_scm;
 177
 178   Grob *cx = script->common_refpoint (slur, X_AXIS);
 179   Grob *cy = script->common_refpoint (slur, Y_AXIS);
 180
 181   Bezier curve = Slur::get_curve (slur);
 182
 183   curve.translate (Offset (slur->relative_coordinate (cx, X_AXIS),
 184                            slur->relative_coordinate (cy, Y_AXIS)));
 185
 186   Interval yext = robust_relative_extent (script, cy, Y_AXIS);
 187   Interval xext = robust_relative_extent (script, cx, X_AXIS);
 188
 189   yext.translate (robust_scm2double (offset_scm, 0));
 190
 191
 192   /* FIXME: slur property, script property?  */
 193   Real slur_padding = robust_scm2double (script->get_property ("slur-padding"),
 194                                          0.0);
 195   yext.widen (slur_padding);
 196
 197   Real EPS = 1e-3;
 198   Interval bezext (curve.control_[0][X_AXIS], curve.control_[3][X_AXIS]);
 199   bool consider[] = { false, false, false };
 200   Real ys[] = {0, 0, 0};
 201   bool do_shift = false;
 202
 203   for (int d = LEFT, k = 0; d <= RIGHT; d++, k++)
 204     {
 205       Real x = xext.linear_combination ((Direction) d);
 206       consider[k] = bezext.contains (x);
 207
 208       if (consider[k])
 209         {
 210           ys[k]
 211             = (fabs (bezext[LEFT] - x) < EPS)
 212             ? curve.control_[0][Y_AXIS]
 213             : ((fabs (bezext[RIGHT] - x) < EPS)
 214                ? curve.control_[3][Y_AXIS]
 215                : curve.get_other_coordinate (X_AXIS, x));
 216
 217           /* Request shift if slur is contained script's Y, or if
 218              script is inside slur and avoid == outside.  */
 219           if (yext.contains (ys[k])
 220               || (dir * ys[k] > dir * yext[-dir] && avoid == ly_symbol2scm ("outside")))
 221             do_shift = true;
 222         }
 223     }
 224
 225   Real avoidance_offset = 0.0;
 226   for (int d = LEFT, k = 0; d <= RIGHT; d++, k++)
 227     if (consider[k])
 228       avoidance_offset = dir * (max (dir * avoidance_offset,
 229                                      dir * (ys[k] - yext[-dir] + dir * slur_padding)));
 230
 231   return scm_from_double (scm_to_double (offset_scm) + avoidance_offset);
 232 }
 233
 234
 235
 236 ADD_INTERFACE (Slur, "slur-interface",
 237
 238                "A slur",
 239
 240                /* properties */
 241                "avoid-slur "    /* UGH. */
 242                "control-points "
 243                "dash-fraction "
 244                "dash-period "
 245                "details "
 246                "direction "
 247                "eccentricity "
 248                "encompass-objects "
 249                "height-limit "
 250                "line-thickness "
 251                "note-columns "
 252                "positions "
 253                "quant-score "
 254                "ratio "
 255                "thickness "
 256
 257                );
 258