2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
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.
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.
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/>.
20 #include "engraver.hh"
23 #include "directional-element-interface.hh"
24 #include "duration.hh"
25 #include "international.hh"
28 #include "rhythmic-head.hh"
29 #include "script-interface.hh"
30 #include "staff-symbol-referencer.hh"
31 #include "stem-tremolo.hh"
33 #include "stream-event.hh"
35 #include "translator.icc"
39 class Stem_engraver : public Engraver
43 vector <Grob *> maybe_flags_;
44 Stream_event *rhythmic_ev_;
45 Stream_event *tremolo_ev_;
48 TRANSLATOR_DECLARATIONS (Stem_engraver);
51 void make_stem (Grob_info, bool);
53 DECLARE_TRANSLATOR_LISTENER (tremolo);
54 DECLARE_TRANSLATOR_LISTENER (tuplet_span);
55 DECLARE_ACKNOWLEDGER (rhythmic_head);
56 void stop_translation_timestep ();
58 void kill_unused_flags ();
61 Stem_engraver::Stem_engraver ()
67 tuplet_start_ = false;
71 Stem_engraver::make_stem (Grob_info gi, bool tuplet_start)
73 /* Announce the cause of the head as cause of the stem. The
74 stem needs a rhythmic structure to fit it into a beam. */
75 stem_ = make_item ("Stem", gi.grob ()->self_scm ());
77 stem_->set_property ("tuplet-start", SCM_BOOL_T);
78 (void) make_item ("StemStub", gi.grob ()->self_scm ());
81 /* Stem tremolo is never applied to a note by default,
82 it must be requested. But there is a default for the
87 the first and last (quarter) note both get one tremolo flag. */
89 = robust_scm2int (tremolo_ev_->get_property ("tremolo-type"), 8);
92 we take the duration log from the Event, since the duration-log
93 for a note head is always <= 2.
95 Stream_event *ev = gi.event_cause ();
96 Duration *dur = unsmob<Duration> (ev->get_property ("duration"));
98 int tremolo_flags = intlog2 (requested_type) - 2
99 - (dur->duration_log () > 2 ? dur->duration_log () - 2 : 0);
100 if (tremolo_flags <= 0)
102 tremolo_ev_->origin ()->warning (_ ("tremolo duration is too long"));
108 tremolo_ = make_item ("StemTremolo", tremolo_ev_->self_scm ());
110 /* The number of tremolo flags is the number of flags of the
111 tremolo-type minus the number of flags of the note itself. */
112 tremolo_->set_property ("flag-count", scm_from_int (tremolo_flags));
113 tremolo_->set_parent (stem_, X_AXIS);
114 stem_->set_object ("tremolo-flag", tremolo_->self_scm ());
115 tremolo_->set_object ("stem", stem_->self_scm ());
121 Stem_engraver::acknowledge_rhythmic_head (Grob_info gi)
123 if (Rhythmic_head::get_stem (gi.grob ()))
126 Stream_event *cause = gi.event_cause ();
129 Duration *d = unsmob<Duration> (cause->get_property ("duration"));
134 make_stem (gi, tuplet_start_);
136 int ds = Stem::duration_log (stem_);
137 int dc = d->duration_log ();
139 // half notes and quarter notes all have compatible stems.
140 // Longas are done differently (oops?), so we can't unify
141 // them with the other stemmed notes.
146 // whole notes and brevis both have no stems
154 gi.event_cause ()->origin ()->warning (_f ("adding note head to incompatible stem (type = %d/%d)",
155 ds < 0 ? 1 << -ds : 1,
156 ds > 0 ? 1 << ds : 1));
157 gi.event_cause ()->origin ()->warning (_ ("maybe input should specify polyphonic voices"));
160 Stem::add_head (stem_, gi.grob ());
162 if (Stem::is_normal_stem (stem_)
163 && Stem::duration_log (stem_) > 2
164 && !(unsmob<Grob> (stem_->get_object ("flag"))))
166 Item *flag = make_item ("Flag", stem_->self_scm ());
167 flag->set_parent (stem_, X_AXIS);
168 stem_->set_object ("flag", flag->self_scm ());
169 maybe_flags_.push_back (flag);
172 stem_->set_property ("tuplet-start", SCM_BOOL_T);
176 Stem_engraver::kill_unused_flags ()
178 for (vsize i = 0; i < maybe_flags_.size (); i++)
179 if (unsmob<Grob> (maybe_flags_[i]->get_parent (X_AXIS)->get_object ("beam")))
180 maybe_flags_[i]->suicide ();
184 Stem_engraver::finalize ()
186 kill_unused_flags ();
190 Stem_engraver::stop_translation_timestep ()
192 if (scm_is_string (get_property ("whichBar")))
193 kill_unused_flags ();
198 /* FIXME: junk these properties. */
199 SCM prop = get_property ("stemLeftBeamCount");
200 if (scm_is_number (prop))
202 Stem::set_beaming (stem_, scm_to_int (prop), LEFT);
203 context ()->unset_property (ly_symbol2scm ("stemLeftBeamCount"));
205 prop = get_property ("stemRightBeamCount");
206 if (scm_is_number (prop))
208 Stem::set_beaming (stem_, scm_to_int (prop), RIGHT);
209 context ()->unset_property (ly_symbol2scm ("stemRightBeamCount"));
213 tuplet_start_ = false;
217 IMPLEMENT_TRANSLATOR_LISTENER (Stem_engraver, tuplet_span);
219 Stem_engraver::listen_tuplet_span (Stream_event *ev)
221 Direction dir = to_dir (ev->get_property ("span-direction"));
224 // set stem property if stem already exists
226 stem_->set_property ("tuplet-start", SCM_BOOL_T);
227 tuplet_start_ = true; // stash the value for use in later creation
231 IMPLEMENT_TRANSLATOR_LISTENER (Stem_engraver, tremolo);
233 Stem_engraver::listen_tremolo (Stream_event *ev)
235 ASSIGN_EVENT_ONCE (tremolo_ev_, ev);
238 ADD_ACKNOWLEDGER (Stem_engraver, rhythmic_head);
240 ADD_TRANSLATOR (Stem_engraver,
242 "Create stems, flags and single-stem tremolos. It also works"
243 " together with the beam engraver for overriding beaming.",
253 "stemRightBeamCount "