/*
- ambitus-engraver.cc -- implement Ambitus_engraver
+ This file is part of LilyPond, the GNU music typesetter.
- source file of the GNU LilyPond music typesetter
+ Copyright (C) 2002--2015 Juergen Reuter <reuter@ipd.uka.de>
- (c) 2002--2003 Juergen Reuter <reuter@ipd.uka.de>
+ Han-Wen Nienhuys <hanwen@xs4all.nl
+
+ LilyPond is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ LilyPond is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
*/
#include "engraver.hh"
+
+#include "accidental-placement.hh"
+#include "axis-group-interface.hh"
#include "item.hh"
#include "note-head.hh"
+#include "pitch-interval.hh"
+#include "pointer-group-interface.hh"
+#include "protected-scm.hh"
+#include "side-position-interface.hh"
+#include "separation-item.hh"
#include "staff-symbol-referencer.hh"
-#include "event.hh"
-#include "pitch.hh"
+#include "stream-event.hh"
+
+#include "translator.icc"
-/*
- * This class implements an engraver for ambitus grobs.
- *
- * TODO: There are quite some conceptional issues left open:
- *
- * - Many publishers put ambitus _before_ the first occurrence of a
- * clef. Hence, formally the pitches are undefined in this case. Of
- * course, one could always silently assume that ambitus pitches refer
- * to the first occurrence of a clef. Or should we, by default, put
- * the ambitus always after the first clef, if any?
- *
- * - Enharmonically equal pitches: Assume piece contains once a "gis",
- * another time an "aes" as highest pitch. Which one should be
- * selected for the ambitus grob? The "aes", because it is
- * musically/notationally "higher" than "gis"? Or "gis", because (if
- * using pure temperament) it has a slightly higher frequency? Or
- * that pitch that come closer to the key signature? But there may be
- * key signature changes in the piece...
- *
- * - Multiple voices in single staff: Assume a vocal piece of music,
- * where the soprano voice and the alto voice are put into the same
- * staff (this is generally a bad idea, but unfortunately common
- * practice). Then, there probably should be two ambitus grobs, one
- * for each voice. But how can you see which ambitus grob refers to
- * which voice? Most probably you can guess it from the fact that the
- * ambitus of the alto voice typically lies in a lower range than that
- * of the soprano voice, but this is just a heuristic rather than a
- * generally valid rule. In the case of only two voices, using stems
- * in the ambitus grob might help, but probably looks quite ugly.
- *
- * - If a piece consists of several loosely coupled sections, should
- * there be multiple ambitus grobs allowed, one for each section?
- * Then there probably should be some "\ambitus" event added to
- * mudela, stating where an ambitus grob should be placed. This
- * ambitus grob should then represent the ambitus in the range of time
- * between this "\ambitus" event and the next one (or the end of the
- * piece, if there is no more such event). To be compliant with the
- * current implementation, we might implicitly assume an "\ambitus"
- * event at the beginning of the piece, but then the question where
- * to put this first ambitus grob (before/after the clef?) becomes
- * even more urgent.
- *
- * - Incipits of transcribed music may need special treatment for
- * ambitus, since, for readability, the ambitus most probably should
- * not refer to the ancient clefs of the incipit, but rather to the
- * clefs used in the transcribed parts.
- */
class Ambitus_engraver : public Engraver
{
public:
-TRANSLATOR_DECLARATIONS(Ambitus_engraver);
- virtual void process_music ();
- virtual void acknowledge_grob (Grob_info);
- virtual void stop_translation_timestep ();
+ TRANSLATOR_DECLARATIONS (Ambitus_engraver);
+protected:
+ void acknowledge_note_head (Grob_info);
+
+ void process_music ();
+ void stop_translation_timestep ();
virtual void finalize ();
+ virtual void derived_mark () const;
private:
void create_ambitus ();
Item *ambitus_;
- int/*bool*/ is_typeset;
- Pitch pitch_min, pitch_max;
+ Item *group_;
+ Drul_array<Item *> heads_;
+ Drul_array<Item *> accidentals_;
+ Drul_array<Stream_event *> causes_;
+ Pitch_interval pitch_interval_;
+ bool is_typeset_;
+ int start_c0_;
+ SCM start_key_sig_;
};
-Ambitus_engraver::Ambitus_engraver ()
+void
+Ambitus_engraver::derived_mark () const
{
- ambitus_ = 0;
- is_typeset = 0;
+ scm_gc_mark (start_key_sig_);
+}
- /*
- * (pitch_min > pitch_max) means that pitches are not yet
- * initialized
- */
- pitch_min = Pitch (0, 0, SHARP);
- pitch_max = Pitch (0, 0, FLAT);
+void
+Ambitus_engraver::create_ambitus ()
+{
+ ambitus_ = make_item ("AmbitusLine", SCM_EOL);
+ group_ = make_item ("Ambitus", SCM_EOL);
+ for (DOWN_and_UP (d))
+ {
+ heads_[d] = make_item ("AmbitusNoteHead", SCM_EOL);
+ accidentals_[d] = make_item ("AmbitusAccidental", SCM_EOL);
+ accidentals_[d]->set_parent (heads_[d], Y_AXIS);
+ heads_[d]->set_object ("accidental-grob",
+ accidentals_[d]->self_scm ());
+ Axis_group_interface::add_element (group_, heads_[d]);
+ Axis_group_interface::add_element (group_, accidentals_[d]);
+ }
+
+ ambitus_->set_parent (heads_[DOWN], X_AXIS);
+ Axis_group_interface::add_element (group_, ambitus_);
+
+ is_typeset_ = false;
+}
+
+Ambitus_engraver::Ambitus_engraver (Context *c)
+ : Engraver (c)
+{
+ ambitus_ = 0;
+ heads_.set (0, 0);
+ accidentals_.set (0, 0);
+ group_ = 0;
+ is_typeset_ = false;
+ start_key_sig_ = SCM_EOL;
}
void
Ambitus_engraver::process_music ()
{
/*
- * Ensure that ambitus is created in the very first timestep (on
- * which lily does not call start_translation_timestep ()).
- * Otherwise, if a voice begins with a rest, the ambitus grob will
- * be placed after the rest.
+ * Ensure that ambitus is created in the very first timestep
*/
- if (!ambitus_) {
+ if (!ambitus_)
create_ambitus ();
- }
}
void
Ambitus_engraver::stop_translation_timestep ()
{
- if (ambitus_ && !is_typeset)
+ if (ambitus_ && !is_typeset_)
{
/*
- * Evaluate centralCPosition not until now, since otherwise we
+ * Evaluate middleCPosition not until now, since otherwise we
* may then oversee a clef that is defined in a staff context if
- * we are in a voice context; centralCPosition would then be
+ * we are in a voice context; middleCPosition would then be
* assumed to be 0.
- */
- SCM c0 = get_property ("centralCPosition");
- ambitus_->set_grob_property ("c0-position", c0);
- /*
- * Similar for keySignature.
+ * Don't use middleCPosition as this may be thwarted by a cue
+ * starting here. middleCOffset is not affected by cue clefs.
*/
- SCM key_signature = get_property ("keySignature");
- ambitus_->set_grob_property ("accidentals", key_signature);
+ int clef_pos = robust_scm2int (get_property ("middleCClefPosition"), 0);
+ int offset = robust_scm2int (get_property ("middleCOffset"), 0);
+
+ start_c0_ = clef_pos + offset;
+ start_key_sig_ = get_property ("keyAlterations");
- typeset_grob (ambitus_);
- is_typeset = 1;
+ is_typeset_ = true;
}
}
void
-Ambitus_engraver::acknowledge_grob (Grob_info info)
+Ambitus_engraver::acknowledge_note_head (Grob_info info)
{
- Item *item = dynamic_cast <Item *>(info.grob_);
- if (item)
+ Stream_event *nr = info.event_cause ();
+ if (nr && nr->in_event_class ("note-event")
+ && !to_boolean (info.grob ()->get_property ("ignore-ambitus")))
{
- if (Note_head::has_interface (info.grob_))
- {
- Music *nr = info.music_cause ();
- if (nr && nr->is_mus_type ("note-event"))
- {
- Pitch pitch = *unsmob_pitch (nr->get_mus_property ("pitch"));
- if (Pitch::compare (pitch_min, pitch_max) > 0) // already init'd?
- {
- // not yet init'd; use current pitch to init min/max
- pitch_min = pitch;
- pitch_max = pitch;
- }
- else if (Pitch::compare (pitch, pitch_max) > 0) // new max?
- {
- pitch_max = pitch;
- }
- else if (Pitch::compare (pitch, pitch_min) < 0) // new min?
- {
- pitch_min = pitch;
- }
- }
- }
+ SCM p = nr->get_property ("pitch");
+ /*
+ If the engraver is added to a percussion context,
+ filter out unpitched note heads.
+ */
+ if (!unsmob<Pitch> (p))
+ return;
+ Pitch pitch = *unsmob<Pitch> (p);
+ Drul_array<bool> expands = pitch_interval_.add_point (pitch);
+ if (expands[UP])
+ causes_[UP] = nr;
+ if (expands[DOWN])
+ causes_[DOWN] = nr;
}
}
void
-Ambitus_engraver::create_ambitus ()
+Ambitus_engraver::finalize ()
{
- SCM basicProperties = get_property ("Ambitus");
- ambitus_ = new Item (basicProperties); is_typeset = 0;
- announce_grob (ambitus_, SCM_EOL);
+ if (ambitus_ && !pitch_interval_.is_empty ())
+ {
+ Grob *accidental_placement
+ = make_item ("AccidentalPlacement", accidentals_[DOWN]->self_scm ());
+
+ for (DOWN_and_UP (d))
+ {
+ Pitch p = pitch_interval_[d];
+ heads_[d]->set_property ("cause", causes_[d]->self_scm ());
+ heads_[d]->set_property ("staff-position",
+ scm_from_int (start_c0_ + p.steps ()));
+
+ SCM handle = scm_assoc (scm_cons (scm_from_int (p.get_octave ()),
+ scm_from_int (p.get_notename ())),
+ start_key_sig_);
+
+ if (scm_is_false (handle))
+ handle = scm_assoc (scm_from_int (p.get_notename ()),
+ start_key_sig_);
+
+ Rational sig_alter = (scm_is_true (handle))
+ ? robust_scm2rational (scm_cdr (handle), Rational (0))
+ : Rational (0);
+
+ const Pitch other = pitch_interval_[-d];
+
+ if (sig_alter == p.get_alteration ()
+ && !((p.steps () == other.steps ())
+ && (p.get_alteration () != other.get_alteration ())))
+ {
+ accidentals_[d]->suicide ();
+ heads_[d]->set_object ("accidental-grob", SCM_EOL);
+ }
+ else
+ accidentals_[d]->
+ set_property ("alteration",
+ ly_rational2scm (p.get_alteration ()));
+ Separation_item::add_conditional_item (heads_[d],
+ accidental_placement);
+ Accidental_placement::add_accidental (accidental_placement,
+ accidentals_[d], false, 0);
+ Pointer_group_interface::add_grob (ambitus_,
+ ly_symbol2scm ("note-heads"),
+ heads_[d]);
+ }
+
+ Axis_group_interface::add_element (group_, accidental_placement);
+ }
+ else
+ {
+ for (DOWN_and_UP (d))
+ {
+ accidentals_[d]->suicide ();
+ heads_[d]->suicide ();
+ }
+
+ ambitus_->suicide ();
+ }
}
void
-Ambitus_engraver::finalize ()
+Ambitus_engraver::boot ()
{
- if (ambitus_)
- {
- if (Pitch::compare (pitch_min, pitch_max) <= 0)
- {
- ambitus_->set_grob_property ("pitch-min",
- pitch_min.smobbed_copy ());
- ambitus_->set_grob_property ("pitch-max",
- pitch_max.smobbed_copy ());
- }
- else // have not seen any pitch, so forget about the ambitus
- {
- /*
- * Do not print a warning on empty ambitus range, since this
- * most probably arises from an empty voice, such as shared
- * global timesig/clef definitions.
- */
- ambitus_->suicide();
- }
- }
+ ADD_ACKNOWLEDGER (Ambitus_engraver, note_head);
}
-ENTER_DESCRIPTION(Ambitus_engraver,
-/* descr */ "",
-/* creats*/ "Ambitus",
-/* accepts */ "",
-/* acks */ "note-head-interface",
-/* reads */ "",
-/* write */ "");
+ADD_TRANSLATOR (Ambitus_engraver,
+ /* doc */
+ "Create an ambitus.",
+
+ /* create */
+ "AccidentalPlacement "
+ "Ambitus "
+ "AmbitusAccidental "
+ "AmbitusLine "
+ "AmbitusNoteHead ",
+
+ /* read */
+ "keyAlterations "
+ "middleCClefPosition "
+ "middleCOffset ",
+
+ /* write */
+ ""
+ );