lily/new-fingering-engraver.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 1998--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 "engraver.hh"
  21
  22 #include "international.hh"
  23 #include "item.hh"
  24 #include "rhythmic-head.hh"
  25 #include "script-interface.hh"
  26 #include "self-alignment-interface.hh"
  27 #include "side-position-interface.hh"
  28 #include "stem.hh"
  29 #include "stream-event.hh"
  30 #include "warn.hh"
  31
  32 #include "translator.icc"
  33
  34 struct Finger_tuple
  35 {
  36   Grob *head_;
  37   Grob *script_;
  38   Stream_event *note_event_;
  39   Stream_event *finger_event_;
  40   bool follow_into_staff_;
  41   int position_;
  42
  43   Finger_tuple ()
  44   {
  45     position_ = 0;
  46     head_ = script_ = 0;
  47     note_event_ = finger_event_ = 0;
  48     follow_into_staff_ = false;
  49   }
  50 };
  51
  52 bool
  53 operator < (Finger_tuple const &a, Finger_tuple const &b)
  54 {
  55   return a.position_ < b.position_;
  56 }
  57
  58 class New_fingering_engraver : public Engraver
  59 {
  60   vector<Finger_tuple> fingerings_;
  61   vector<Finger_tuple> stroke_fingerings_;
  62   vector<Finger_tuple> articulations_;
  63   vector<Finger_tuple> string_numbers_;
  64
  65   vector<Grob *> heads_;
  66   vector<Grob *> accidentals_;
  67   Grob *stem_;
  68
  69   void position_all ();
  70 public:
  71   TRANSLATOR_DECLARATIONS (New_fingering_engraver);
  72 protected:
  73   void stop_translation_timestep ();
  74   void acknowledge_rhythmic_head (Grob_info);
  75   void acknowledge_inline_accidental (Grob_info);
  76   void acknowledge_stem (Grob_info);
  77   void add_fingering (Grob *, SCM,
  78                       vector<Finger_tuple> *,
  79                       Stream_event *, Stream_event *);
  80   void add_script (Grob *, Stream_event *, Stream_event *);
  81   void add_string (Grob *, Stream_event *, Stream_event *);
  82   void position_scripts (SCM orientations, vector<Finger_tuple> *);
  83 };
  84
  85 void
  86 New_fingering_engraver::acknowledge_inline_accidental (Grob_info inf)
  87 {
  88   accidentals_.push_back (inf.grob ());
  89 }
  90
  91 void
  92 New_fingering_engraver::acknowledge_rhythmic_head (Grob_info inf)
  93 {
  94   Stream_event *note_ev = inf.event_cause ();
  95   if (!note_ev)
  96     return;
  97
  98   SCM arts = note_ev->get_property ("articulations");
  99
 100   for (SCM s = arts; scm_is_pair (s); s = scm_cdr (s))
 101     {
 102       Stream_event *ev = unsmob<Stream_event> (scm_car (s));
 103
 104       if (!ev)
 105         continue;
 106
 107       if (ev->in_event_class ("fingering-event"))
 108         add_fingering (inf.grob (),
 109                        ly_symbol2scm ("Fingering"),
 110                        &fingerings_,
 111                        ev, note_ev);
 112       else if (ev->in_event_class ("text-script-event"))
 113         ev->origin ()->warning (_ ("cannot add text scripts to individual note heads"));
 114       else if (ev->in_event_class ("script-event"))
 115         add_script (inf.grob (), ev, note_ev);
 116       else if (ev->in_event_class ("string-number-event"))
 117         {
 118           // String numbers are used in calculating harmonics even
 119           // when we don't want them displayed.  So don't make space
 120           // for them if 'stencil is #f
 121           Grob *g = make_item ("StringNumber", ev->self_scm ());
 122           if (scm_is_true (g->get_property ("stencil")))
 123             add_fingering (inf.grob (),
 124                            ly_symbol2scm ("StringNumber"), &string_numbers_,
 125                            ev, note_ev);
 126           g->suicide (); // Kill grob created to check stencil
 127         }
 128       else if (ev->in_event_class ("stroke-finger-event"))
 129         add_fingering (inf.grob (),
 130                        ly_symbol2scm ("StrokeFinger"), &stroke_fingerings_,
 131                        ev, note_ev);
 132       else if (ev->in_event_class ("harmonic-event"))
 133         {
 134           inf.grob ()->set_property ("style", ly_symbol2scm ("harmonic"));
 135           Grob *d = unsmob<Grob> (inf.grob ()->get_object ("dot"));
 136           if (d && !to_boolean (get_property ("harmonicDots")))
 137             d->suicide ();
 138         }
 139     }
 140
 141   heads_.push_back (inf.grob ());
 142 }
 143
 144 void
 145 New_fingering_engraver::acknowledge_stem (Grob_info inf)
 146 {
 147   stem_ = inf.grob ();
 148 }
 149
 150 void
 151 New_fingering_engraver::add_script (Grob *head,
 152                                     Stream_event *event,
 153                                     Stream_event * /* note */)
 154 {
 155   Finger_tuple ft;
 156
 157   Grob *g = make_item ("Script", event->self_scm ());
 158   make_script_from_event (g, context (),
 159                           event->get_property ("articulation-type"), 0);
 160   ft.script_ = g;
 161   ft.script_->set_parent (head, X_AXIS);
 162
 163   SCM forced_dir = event->get_property ("direction");
 164   if (to_dir (forced_dir))
 165     ft.script_->set_property ("direction", forced_dir);
 166
 167   articulations_.push_back (ft);
 168 }
 169
 170 void
 171 New_fingering_engraver::add_fingering (Grob *head,
 172                                        SCM grob_sym,
 173                                        vector<Finger_tuple> *tuple_vector,
 174                                        Stream_event *event,
 175                                        Stream_event *hevent)
 176 {
 177   Finger_tuple ft;
 178
 179   ft.script_ = make_item (grob_sym, event->self_scm ());
 180
 181   Side_position_interface::add_support (ft.script_, head);
 182
 183   ft.finger_event_ = event;
 184   ft.note_event_ = hevent;
 185   ft.head_ = head;
 186
 187   tuple_vector->push_back (ft);
 188 }
 189
 190 void
 191 New_fingering_engraver::position_scripts (SCM orientations,
 192                                           vector<Finger_tuple> *scripts)
 193 {
 194   for (vsize i = 0; i < scripts->size (); i++)
 195     if (stem_)
 196       {
 197         Side_position_interface::add_support (scripts->at (i).script_, stem_);
 198         if (Grob *flag = unsmob<Grob> (stem_->get_object ("flag")))
 199           Side_position_interface::add_support (scripts->at (i).script_, flag);
 200       }
 201
 202   /*
 203     This is not extremely elegant, but we have to do a little
 204     formatting here, because the parent/child relations should be
 205     known before we move on to the next time step.
 206
 207     A more sophisticated approach would be to set both X and Y parents
 208     to the note head, and write a more flexible function for
 209     positioning the fingerings, setting both X and Y coordinates.
 210   */
 211   for (vsize i = 0; i < scripts->size (); i++)
 212     (*scripts)[i].position_ = scm_to_int ((*scripts)[i].head_->get_property ("staff-position"));
 213
 214   for (vsize i = scripts->size (); i--;)
 215     for (vsize j = heads_.size (); j--;)
 216       Side_position_interface::add_support ((*scripts)[i].script_, heads_[j]);
 217
 218   vector<Finger_tuple> up, down, horiz;
 219   for (vsize i = scripts->size (); i--;)
 220     {
 221       SCM d = (*scripts)[i].finger_event_->get_property ("direction");
 222       if (to_dir (d))
 223         {
 224           ((to_dir (d) == UP) ? up : down).push_back ((*scripts)[i]);
 225           scripts->erase (scripts->begin () + i);
 226         }
 227     }
 228
 229   vector_sort (*scripts, less<Finger_tuple> ());
 230
 231   bool up_p = scm_is_true (scm_c_memq (ly_symbol2scm ("up"), orientations));
 232   bool down_p = scm_is_true (scm_c_memq (ly_symbol2scm ("down"), orientations));
 233   bool left_p = scm_is_true (scm_c_memq (ly_symbol2scm ("left"), orientations));
 234   bool right_p = scm_is_true (scm_c_memq (ly_symbol2scm ("right"), orientations));
 235   Direction hordir = (right_p) ? RIGHT : LEFT;
 236   if (left_p || right_p)
 237     {
 238       if (up_p && !up.size () && scripts->size ())
 239         {
 240           up.push_back (scripts->back ());
 241           scripts->pop_back ();
 242         }
 243
 244       if (down_p && !down.size () && scripts->size ())
 245         {
 246           down.push_back ((*scripts)[0]);
 247           scripts->erase (scripts->begin ());
 248         }
 249
 250       horiz.insert (horiz.end (), scripts->begin (), scripts->end ());
 251     }
 252   else if (up_p && down_p)
 253     {
 254       int center = scripts->size () / 2;
 255       down.insert (down.end (), scripts->begin (), scripts->begin () + center);
 256       up.insert (up.end (), scripts->begin () + center, scripts->end ());
 257     }
 258   else if (up_p)
 259     {
 260       up.insert (up.end (), scripts->begin (), scripts->end ());
 261       scripts->clear ();
 262     }
 263   else
 264     {
 265       if (!down_p)
 266         {
 267           warning (_ ("no placement found for fingerings"));
 268           warning (_ ("placing below"));
 269         }
 270       down.insert (down.end (), scripts->begin (), scripts->end ());
 271       scripts->clear ();
 272     }
 273
 274   for (vsize i = 0; i < horiz.size (); i++)
 275     {
 276       Finger_tuple ft = horiz[i];
 277       Grob *f = ft.script_;
 278       f->set_parent (ft.head_, X_AXIS);
 279       f->set_parent (ft.head_, Y_AXIS);
 280       f->set_property ("avoid-slur", ly_symbol2scm ("inside"));
 281       if (hordir == LEFT
 282           && unsmob<Grob> (ft.head_->get_object ("accidental-grob")))
 283         Side_position_interface::add_support (f,
 284                                               unsmob<Grob> (ft.head_->get_object ("accidental-grob")));
 285       else if (unsmob<Grob> (ft.head_->get_object ("dot")))
 286         Side_position_interface::add_support (f,
 287                                               unsmob<Grob> (ft.head_->get_object ("dot")));
 288
 289       Self_alignment_interface::set_aligned_on_parent (f, Y_AXIS);
 290       Side_position_interface::set_axis (f, X_AXIS);
 291
 292       f->set_property ("direction", scm_from_int (hordir));
 293     }
 294
 295   Drul_array< vector<Finger_tuple> > vertical (down, up);
 296   for (DOWN_and_UP (d))
 297     {
 298       for (vsize i = 0; i < vertical[d].size (); i++)
 299         {
 300           Finger_tuple ft = vertical[d][i];
 301           Grob *f = ft.script_;
 302           int finger_prio = robust_scm2int (f->get_property ("script-priority"), 200);
 303           f->set_parent (ft.head_, X_AXIS);
 304           f->set_property ("script-priority",
 305                            scm_from_int (finger_prio + d * ft.position_));
 306
 307           Self_alignment_interface::set_aligned_on_parent (f, X_AXIS);
 308           Side_position_interface::set_axis (f, Y_AXIS);
 309
 310           f->set_property ("direction", scm_from_int (d));
 311         }
 312     }
 313 }
 314
 315 void
 316 New_fingering_engraver::stop_translation_timestep ()
 317 {
 318   position_all ();
 319   stem_ = 0;
 320   heads_.clear ();
 321 }
 322
 323 void
 324 New_fingering_engraver::position_all ()
 325 {
 326   if (fingerings_.size ())
 327     {
 328       position_scripts (get_property ("fingeringOrientations"),
 329                         &fingerings_);
 330       fingerings_.clear ();
 331     }
 332
 333   if (string_numbers_.size ())
 334     {
 335       position_scripts (get_property ("stringNumberOrientations"),
 336                         &string_numbers_);
 337       string_numbers_.clear ();
 338     }
 339
 340   if (stroke_fingerings_.size ())
 341     {
 342       position_scripts (get_property ("strokeFingerOrientations"),
 343                         &stroke_fingerings_);
 344       stroke_fingerings_.clear ();
 345     }
 346
 347   for (vsize i = articulations_.size (); i--;)
 348     {
 349       Grob *script = articulations_[i].script_;
 350
 351       for (vsize j = 0; j < accidentals_.size (); j++)
 352         Side_position_interface::add_support (script, accidentals_[j]);
 353
 354       accidentals_.resize (0);
 355       for (vsize j = heads_.size (); j--;)
 356         Side_position_interface::add_support (script, heads_[j]);
 357
 358       if (stem_ && to_dir (script->get_property ("side-relative-direction")))
 359         script->set_object ("direction-source", stem_->self_scm ());
 360
 361       if (stem_ && to_boolean (script->get_property ("add-stem-support")))
 362         Side_position_interface::add_support (script, stem_);
 363     }
 364   articulations_.clear ();
 365 }
 366
 367 New_fingering_engraver::New_fingering_engraver (Context *c)
 368   : Engraver (c)
 369 {
 370   stem_ = 0;
 371 }
 372
 373
 374 void
 375 New_fingering_engraver::boot ()
 376 {
 377   ADD_ACKNOWLEDGER (New_fingering_engraver, rhythmic_head);
 378   ADD_ACKNOWLEDGER (New_fingering_engraver, inline_accidental);
 379   ADD_ACKNOWLEDGER (New_fingering_engraver, stem);
 380 }
 381
 382 ADD_TRANSLATOR (New_fingering_engraver,
 383                 /* doc */
 384                 "Create fingering scripts for notes in a new chord.  This"
 385                 " engraver is ill-named, since it also takes care of"
 386                 " articulations and harmonic note heads.",
 387
 388                 /* create */
 389                 "Fingering "
 390                 "StringNumber "
 391                 "StrokeFinger "
 392                 "Script ",
 393
 394                 /* read */
 395                 "fingeringOrientations "
 396                 "harmonicDots "
 397                 "strokeFingerOrientations "
 398                 "stringNumberOrientations ",
 399
 400                 /* write */
 401                 ""
 402                );