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_FOR (Slur_engraver, extra_object, inline_accidental);
  72   ADD_ACKNOWLEDGER_FOR (Slur_engraver, extra_object, fingering);
  73   ADD_ACKNOWLEDGER (Slur_engraver, note_column);
  74   ADD_ACKNOWLEDGER (Slur_engraver, script);
  75   ADD_ACKNOWLEDGER_FOR (Slur_engraver, extra_object, text_script);
  76   ADD_ACKNOWLEDGER_FOR (Slur_engraver, extra_object, dots);
  77   ADD_END_ACKNOWLEDGER_FOR (Slur_engraver, extra_object, tie);
  78   ADD_ACKNOWLEDGER_FOR (Slur_engraver, extra_object, 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_note_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_note_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_script (Grob_info info)
 175 {
 176   if (!info.grob ()->internal_has_interface (ly_symbol2scm ("dynamic-interface")))
 177     acknowledge_extra_object (info);
 178 }
 179
 180 void
 181 Slur_engraver::finalize ()
 182 {
 183   for (vsize i = 0; i < slurs_.size (); i++)
 184     {
 185       slurs_[i]->warning (_f ("unterminated %s", object_name ()));
 186       slurs_[i]->suicide ();
 187     }
 188   slurs_.clear ();
 189 }
 190
 191 void
 192 Slur_engraver::create_slur (SCM spanner_id, Event_info evi, Grob *g_cause, Direction dir, bool left_broken)
 193 {
 194   Grob *ccc = left_broken
 195     ? unsmob<Grob> (get_property ("currentCommandColumn"))
 196     : 0; // efficiency
 197   SCM cause = evi.slur_ ? evi.slur_->self_scm () : g_cause->self_scm ();
 198   Spanner *slur = make_spanner (grob_symbol (), cause);
 199   slur->set_property ("spanner-id", spanner_id);
 200   if (dir)
 201     set_grob_direction (slur, dir);
 202   if (left_broken)
 203     slur->set_bound (LEFT, ccc);
 204   slurs_.push_back (slur);
 205   if (evi.note_)
 206     note_slurs_[START].insert (Note_slurs::value_type (evi.note_, slur));
 207
 208   if (double_property ())
 209   {
 210     set_grob_direction (slur, DOWN);
 211     slur = make_spanner (grob_symbol (), cause);
 212     slur->set_property ("spanner-id", spanner_id);
 213     set_grob_direction (slur, UP);
 214     if (left_broken)
 215       slur->set_bound (LEFT, ccc);
 216     slurs_.push_back (slur);
 217     if (evi.note_)
 218       note_slurs_[START].insert(Note_slurs::value_type (evi.note_, slur));
 219   }
 220
 221 }
 222
 223 bool
 224 Slur_engraver::can_create_slur (SCM id, vsize old_slurs, vsize *event_idx, Stream_event *ev)
 225 {
 226   for (vsize j = slurs_.size (); j--;)
 227     {
 228       Grob *slur = slurs_[j];
 229       Direction updown = to_dir (ev->get_property ("direction"));
 230
 231       // Check if we already have a slur with the same spanner-id.
 232       if (ly_is_equal (id, slur->get_property ("spanner-id")))
 233         {
 234           if (j < old_slurs)
 235             {
 236               // We already have an old slur, so give a warning
 237               // and completely ignore the new slur.
 238               ev->origin ()->warning (_f ("already have %s", object_name ()));
 239               if (event_idx)
 240                 start_events_.erase (start_events_.begin () + (*event_idx));
 241               return false;
 242             }
 243
 244           // If this slur event has no direction, it will not
 245           // contribute anything new to the existing slur(s), so
 246           // we can ignore it.
 247
 248           if (!updown)
 249             return false;
 250
 251           Stream_event *c = unsmob<Stream_event> (slur->get_property ("cause"));
 252
 253           if (!c)
 254             {
 255               slur->programming_error (_f ("%s without a cause", object_name ()));
 256               return true;
 257             }
 258
 259           Direction slur_dir = to_dir (c->get_property ("direction"));
 260
 261           // If the existing slur does not have a direction yet,
 262           // we'd rather take the new one.
 263
 264           if (!slur_dir)
 265             {
 266               slur->suicide ();
 267               slurs_.erase (slurs_.begin () + j);
 268               return true;
 269             }
 270
 271           // If the existing slur has the same direction as ours, drop ours
 272
 273           if (slur_dir == updown)
 274             return false;
 275         }
 276     }
 277   return true;
 278 }
 279
 280 bool
 281 Slur_engraver::try_to_end (Event_info evi)
 282 {
 283   SCM id = evi.slur_->get_property ("spanner-id");
 284
 285   // Find the slurs that are ended with this event (by checking the spanner-id)
 286   bool ended = false;
 287   for (vsize j = slurs_.size (); j--;)
 288     {
 289       if (ly_is_equal (id, slurs_[j]->get_property ("spanner-id")))
 290         {
 291           ended = true;
 292           end_slurs_.push_back (slurs_[j]);
 293           if (evi.note_)
 294             note_slurs_[STOP].insert
 295               (Note_slurs::value_type
 296                (evi.note_, dynamic_cast <Spanner *> (slurs_[j])));
 297           slurs_.erase (slurs_.begin () + j);
 298         }
 299     }
 300   return ended;
 301 }
 302
 303 void
 304 Slur_engraver::process_music ()
 305 {
 306   for (vsize i = 0; i < stop_events_.size (); i++)
 307     {
 308       SCM id = stop_events_[i].slur_->get_property ("spanner-id");
 309       bool ended = try_to_end (stop_events_[i]);
 310       if (ended)
 311         {
 312           // Ignore redundant stop events for this id
 313           for (vsize j = stop_events_.size (); --j > i;)
 314             {
 315               if (ly_is_equal (id, stop_events_[j].slur_->get_property ("spanner-id")))
 316                 stop_events_.erase (stop_events_.begin () + j);
 317             }
 318         }
 319       else
 320         stop_events_[i].slur_->origin ()->warning (_f ("cannot end %s", object_name ()));
 321     }
 322
 323   vsize old_slurs = slurs_.size ();
 324   for (vsize i = start_events_.size (); i--;)
 325     {
 326       Stream_event *ev = start_events_[i].slur_;
 327       SCM id = ev->get_property ("spanner-id");
 328       Direction updown = to_dir (ev->get_property ("direction"));
 329
 330       if (can_create_slur (id, old_slurs, &i, ev))
 331         create_slur (id, start_events_[i], 0, updown, false);
 332     }
 333
 334   set_melisma (slurs_.size ());
 335 }
 336
 337 void
 338 Slur_engraver::stop_translation_timestep ()
 339 {
 340   if (Grob *g = unsmob<Grob> (get_property ("currentCommandColumn")))
 341     {
 342       for (vsize i = 0; i < end_slurs_.size (); i++)
 343         Slur::add_extra_encompass (end_slurs_[i], g);
 344
 345       if (!start_events_.size ())
 346         for (vsize i = 0; i < slurs_.size (); i++)
 347           Slur::add_extra_encompass (slurs_[i], g);
 348     }
 349
 350   for (vsize i = 0; i < end_slurs_.size (); i++)
 351     {
 352       Spanner *s = dynamic_cast<Spanner *> (end_slurs_[i]);
 353       if (!s->get_bound (RIGHT))
 354         s->set_bound (RIGHT, unsmob<Grob> (get_property ("currentMusicalColumn")));
 355       announce_end_grob (s, SCM_EOL);
 356     }
 357
 358   for (vsize i = 0; i < objects_to_acknowledge_.size (); i++)
 359     Slur::auxiliary_acknowledge_extra_object (objects_to_acknowledge_[i], slurs_, end_slurs_);
 360
 361   note_slurs_[LEFT].clear ();
 362   note_slurs_[RIGHT].clear ();
 363   objects_to_acknowledge_.clear ();
 364   end_slurs_.clear ();
 365   start_events_.clear ();
 366   stop_events_.clear ();
 367 }