lily/slur-engraver.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
   5
   6   LilyPond is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   LilyPond is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #include "context.hh"
  21 #include "directional-element-interface.hh"
  22 #include "international.hh"
  23 #include "note-column.hh"
  24 #include "pointer-group-interface.hh"
  25 #include "slur-engraver.hh"
  26 #include "slur.hh"
  27 #include "spanner.hh"
  28 #include "warn.hh"
  29
  30 #include "translator.icc"
  31
  32 SCM
  33 Slur_engraver::event_symbol () const
  34 {
  35   return ly_symbol2scm ("slur-event");
  36 }
  37
  38 bool
  39 Slur_engraver::double_property () const
  40 {
  41   return to_boolean (get_property ("doubleSlurs"));
  42 }
  43
  44 SCM
  45 Slur_engraver::grob_symbol () const
  46 {
  47   return ly_symbol2scm ("Slur");
  48 }
  49
  50 const char *
  51 Slur_engraver::object_name () const
  52 {
  53   return "slur";
  54 }
  55
  56 Slur_engraver::Slur_engraver ()
  57 {
  58 }
  59
  60 void
  61 Slur_engraver::set_melisma (bool m)
  62 {
  63   context ()->set_property ("slurMelismaBusy", ly_bool2scm (m));
  64 }
  65
  66 void
  67 Slur_engraver::boot ()
  68 {
  69   ADD_LISTENER (Slur_engraver, slur);
  70   ADD_LISTENER (Slur_engraver, note);
  71   ADD_ACKNOWLEDGER (Slur_engraver, inline_accidental);
  72   ADD_ACKNOWLEDGER (Slur_engraver, fingering);
  73   ADD_ACKNOWLEDGER (Slur_engraver, note_column);
  74   ADD_ACKNOWLEDGER (Slur_engraver, script);
  75   ADD_ACKNOWLEDGER (Slur_engraver, text_script);
  76   ADD_ACKNOWLEDGER (Slur_engraver, dots);
  77   ADD_END_ACKNOWLEDGER (Slur_engraver, tie);
  78   ADD_ACKNOWLEDGER (Slur_engraver, tuplet_number);
  79 }
  80
  81 ADD_TRANSLATOR (Slur_engraver,
  82                 /* doc */
  83                 "Build slur grobs from slur events.",
  84
  85                 /* create */
  86                 "Slur ",
  87
  88                 /* read */
  89                 "slurMelismaBusy "
  90                 "doubleSlurs ",
  91
  92                 /* write */
  93                 ""
  94                );
  95
  96 void
  97 Slur_engraver::derived_mark () const
  98 {
  99   for (vsize i = start_events_.size (); i--;)
 100     {
 101       scm_gc_mark (start_events_[i].slur_->self_scm ());
 102       if (start_events_[i].note_)
 103         scm_gc_mark (start_events_[i].note_->self_scm ());
 104     }
 105   for (vsize i = stop_events_.size (); i--;)
 106     {
 107       scm_gc_mark (stop_events_[i].slur_->self_scm ());
 108       if (stop_events_[i].note_)
 109         scm_gc_mark (stop_events_[i].note_->self_scm ());
 110     }
 111 }
 112
 113 void
 114 Slur_engraver::listen_slur (Stream_event *ev, Stream_event *note)
 115 {
 116   Direction d = to_dir (ev->get_property ("span-direction"));
 117   if (d == START)
 118     start_events_.push_back (Event_info (ev, note));
 119   else if (d == STOP)
 120     stop_events_.push_back (Event_info (ev, note));
 121   else ev->origin ()->warning (_f ("direction of %s invalid: %d",
 122                                    ev->name ().c_str (),
 123                                    int (d)));
 124 }
 125
 126 void
 127 Slur_engraver::listen_note (Stream_event *ev)
 128 {
 129   for (SCM arts = ev->get_property ("articulations");
 130        scm_is_pair (arts); arts = scm_cdr (arts))
 131     {
 132       Stream_event *art = unsmob<Stream_event> (scm_car (arts));
 133       if (art->in_event_class (event_symbol ()))
 134         listen_slur (art, ev);
 135     }
 136 }
 137
 138 void
 139 Slur_engraver::acknowledge_note_column (Grob_info info)
 140 {
 141   Grob *e = info.grob ();
 142   for (vsize i = slurs_.size (); i--;)
 143     Slur::add_column (slurs_[i], e);
 144   for (vsize i = end_slurs_.size (); i--;)
 145     Slur::add_column (end_slurs_[i], e);
 146   // Now cater for slurs starting/ending at a notehead: those override
 147   // the column bounds
 148   if (note_slurs_[START].empty () && note_slurs_[STOP].empty ())
 149     return;
 150   extract_grob_set (e, "note-heads", heads);
 151   for (vsize i = heads.size (); i--;)
 152     {
 153       if (Stream_event *ev =
 154           unsmob<Stream_event> (heads[i]->get_property ("cause")))
 155         for (LEFT_and_RIGHT (d))
 156           {
 157             std::pair<Note_slurs::const_iterator, Note_slurs::const_iterator> its
 158               = note_slurs_[d].equal_range (ev);
 159             for (Note_slurs::const_iterator it = its.first;
 160                  it != its.second;
 161                  ++it)
 162               it->second->set_bound (d, heads[i]);
 163           }
 164     }
 165 }
 166
 167 void
 168 Slur_engraver::acknowledge_extra_object (Grob_info info)
 169 {
 170   objects_to_acknowledge_.push_back (info);
 171 }
 172
 173 void
 174 Slur_engraver::acknowledge_inline_accidental (Grob_info info)
 175 {
 176   acknowledge_extra_object (info);
 177 }
 178
 179 void
 180 Slur_engraver::acknowledge_dots (Grob_info info)
 181 {
 182   acknowledge_extra_object (info);
 183 }
 184
 185 void
 186 Slur_engraver::acknowledge_fingering (Grob_info info)
 187 {
 188   acknowledge_extra_object (info);
 189 }
 190
 191 void
 192 Slur_engraver::acknowledge_tuplet_number (Grob_info info)
 193 {
 194   acknowledge_extra_object (info);
 195 }
 196
 197 void
 198 Slur_engraver::acknowledge_script (Grob_info info)
 199 {
 200   if (!info.grob ()->internal_has_interface (ly_symbol2scm ("dynamic-interface")))
 201     acknowledge_extra_object (info);
 202 }
 203
 204 void
 205 Slur_engraver::acknowledge_text_script (Grob_info info)
 206 {
 207   acknowledge_extra_object (info);
 208 }
 209
 210 void
 211 Slur_engraver::acknowledge_end_tie (Grob_info info)
 212 {
 213   acknowledge_extra_object (info);
 214 }
 215
 216 void
 217 Slur_engraver::finalize ()
 218 {
 219   for (vsize i = 0; i < slurs_.size (); i++)
 220     {
 221       slurs_[i]->warning (_f ("unterminated %s", object_name ()));
 222       slurs_[i]->suicide ();
 223     }
 224   slurs_.clear ();
 225 }
 226
 227 void
 228 Slur_engraver::create_slur (const string &spanner_id, Event_info evi, Grob *g_cause, Direction dir, bool left_broken)
 229 {
 230   Grob *ccc = left_broken
 231     ? unsmob<Grob> (get_property ("currentCommandColumn"))
 232     : 0; // efficiency
 233   SCM cause = evi.slur_ ? evi.slur_->self_scm () : g_cause->self_scm ();
 234   Spanner *slur = make_spanner (grob_symbol (), cause);
 235   slur->set_property ("spanner-id", ly_string2scm (spanner_id));
 236   if (dir)
 237     set_grob_direction (slur, dir);
 238   if (left_broken)
 239     slur->set_bound (LEFT, ccc);
 240   slurs_.push_back (slur);
 241   if (evi.note_)
 242     note_slurs_[START].insert (Note_slurs::value_type (evi.note_, slur));
 243
 244   if (double_property ())
 245   {
 246     set_grob_direction (slur, DOWN);
 247     slur = make_spanner (grob_symbol (), cause);
 248     slur->set_property ("spanner-id", ly_string2scm (spanner_id));
 249     set_grob_direction (slur, UP);
 250     if (left_broken)
 251       slur->set_bound (LEFT, ccc);
 252     slurs_.push_back (slur);
 253     if (evi.note_)
 254       note_slurs_[START].insert(Note_slurs::value_type (evi.note_, slur));
 255   }
 256
 257 }
 258
 259 bool
 260 Slur_engraver::can_create_slur (const string &id, vsize old_slurs, vsize *event_idx, Stream_event *ev)
 261 {
 262   for (vsize j = slurs_.size (); j--;)
 263     {
 264       Grob *slur = slurs_[j];
 265       Direction updown = to_dir (ev->get_property ("direction"));
 266
 267       // Check if we already have a slur with the same spanner-id.
 268       if (id == robust_scm2string (slur->get_property ("spanner-id"), ""))
 269         {
 270           if (j < old_slurs)
 271             {
 272               // We already have an old slur, so give a warning
 273               // and completely ignore the new slur.
 274               ev->origin ()->warning (_f ("already have %s", object_name ()));
 275               if (event_idx)
 276                 start_events_.erase (start_events_.begin () + (*event_idx));
 277               return false;
 278             }
 279
 280           // If this slur event has no direction, it will not
 281           // contribute anything new to the existing slur(s), so
 282           // we can ignore it.
 283
 284           if (!updown)
 285             return false;
 286
 287           Stream_event *c = unsmob<Stream_event> (slur->get_property ("cause"));
 288
 289           if (!c)
 290             {
 291               slur->programming_error (_f ("%s without a cause", object_name ()));
 292               return true;
 293             }
 294
 295           Direction slur_dir = to_dir (c->get_property ("direction"));
 296
 297           // If the existing slur does not have a direction yet,
 298           // we'd rather take the new one.
 299
 300           if (!slur_dir)
 301             {
 302               slur->suicide ();
 303               slurs_.erase (slurs_.begin () + j);
 304               return true;
 305             }
 306
 307           // If the existing slur has the same direction as ours, drop ours
 308
 309           if (slur_dir == updown)
 310             return false;
 311         }
 312     }
 313   return true;
 314 }
 315
 316 bool
 317 Slur_engraver::try_to_end (Event_info evi)
 318 {
 319   string id = robust_scm2string (evi.slur_->get_property ("spanner-id"), "");
 320
 321   // Find the slurs that are ended with this event (by checking the spanner-id)
 322   bool ended = false;
 323   for (vsize j = slurs_.size (); j--;)
 324     {
 325       if (id == robust_scm2string (slurs_[j]->get_property ("spanner-id"), ""))
 326         {
 327           ended = true;
 328           end_slurs_.push_back (slurs_[j]);
 329           if (evi.note_)
 330             note_slurs_[STOP].insert
 331               (Note_slurs::value_type
 332                (evi.note_, dynamic_cast <Spanner *> (slurs_[j])));
 333           slurs_.erase (slurs_.begin () + j);
 334         }
 335     }
 336   return ended;
 337 }
 338
 339 void
 340 Slur_engraver::process_music ()
 341 {
 342   for (vsize i = 0; i < stop_events_.size (); i++)
 343     {
 344       string id = robust_scm2string
 345         (stop_events_[i].slur_->get_property ("spanner-id"), "");
 346       bool ended = try_to_end (stop_events_[i]);
 347       if (ended)
 348         {
 349           // Ignore redundant stop events for this id
 350           for (vsize j = stop_events_.size (); --j > i;)
 351             {
 352               if (id == robust_scm2string
 353                   (stop_events_[j].slur_->get_property ("spanner-id"), ""))
 354                 stop_events_.erase (stop_events_.begin () + j);
 355             }
 356         }
 357       else
 358         stop_events_[i].slur_->origin ()->warning (_f ("cannot end %s", object_name ()));
 359     }
 360
 361   vsize old_slurs = slurs_.size ();
 362   for (vsize i = start_events_.size (); i--;)
 363     {
 364       Stream_event *ev = start_events_[i].slur_;
 365       string id = robust_scm2string (ev->get_property ("spanner-id"), "");
 366       Direction updown = to_dir (ev->get_property ("direction"));
 367
 368       if (can_create_slur (id, old_slurs, &i, ev))
 369         create_slur (id, start_events_[i], 0, updown, false);
 370     }
 371
 372   set_melisma (slurs_.size ());
 373 }
 374
 375 void
 376 Slur_engraver::stop_translation_timestep ()
 377 {
 378   if (Grob *g = unsmob<Grob> (get_property ("currentCommandColumn")))
 379     {
 380       for (vsize i = 0; i < end_slurs_.size (); i++)
 381         Slur::add_extra_encompass (end_slurs_[i], g);
 382
 383       if (!start_events_.size ())
 384         for (vsize i = 0; i < slurs_.size (); i++)
 385           Slur::add_extra_encompass (slurs_[i], g);
 386     }
 387
 388   for (vsize i = 0; i < end_slurs_.size (); i++)
 389     {
 390       Spanner *s = dynamic_cast<Spanner *> (end_slurs_[i]);
 391       if (!s->get_bound (RIGHT))
 392         s->set_bound (RIGHT, unsmob<Grob> (get_property ("currentMusicalColumn")));
 393       announce_end_grob (s, SCM_EOL);
 394     }
 395
 396   for (vsize i = 0; i < objects_to_acknowledge_.size (); i++)
 397     Slur::auxiliary_acknowledge_extra_object (objects_to_acknowledge_[i], slurs_, end_slurs_);
 398
 399   note_slurs_[LEFT].clear ();
 400   note_slurs_[RIGHT].clear ();
 401   objects_to_acknowledge_.clear ();
 402   end_slurs_.clear ();
 403   start_events_.clear ();
 404   stop_events_.clear ();
 405 }