/*
accidental-engraver.cc -- implement accidental_engraver
+ source file of the GNU LilyPond music typesetter
+
(c) 1997--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
Modified 2001--2002 by Rune Zedeler <rz@daimi.au.dk>
*/
+#include "accidental-placement.hh"
+#include "arpeggio.hh"
+#include "context.hh"
+#include "engraver.hh"
#include "event.hh"
-
-
#include "item.hh"
-#include "tie.hh"
+#include "protected-scm.hh"
#include "rhythmic-head.hh"
-#include "engraver-group-engraver.hh"
-#include "accidental-placement.hh"
#include "side-position-interface.hh"
-#include "engraver.hh"
-#include "arpeggio.hh"
+#include "spanner.hh"
+#include "tie.hh"
#include "warn.hh"
-#include "context.hh"
-#include "protected-scm.hh"
-struct Accidental_entry {
+class Accidental_entry
+{
+public:
bool done_;
- Music * melodic_;
- Grob * accidental_;
+ Music *melodic_;
+ Grob *accidental_;
Context *origin_;
- Grob* head_;
- Accidental_entry();
+ Engraver *origin_trans_;
+ Grob *head_;
+ bool tied_;
+
+ Accidental_entry ();
};
-Accidental_entry::Accidental_entry()
+Accidental_entry::Accidental_entry ()
{
+ tied_ = false;
done_ = false;
- melodic_ =0;
+ melodic_ = 0;
accidental_ = 0;
origin_ = 0;
head_ = 0;
}
-struct Accidental_engraver : Engraver {
+class Accidental_engraver : public Engraver
+{
+public:
+ int get_bar_number ();
+ void update_local_key_signature ();
+
protected:
TRANSLATOR_DECLARATIONS (Accidental_engraver);
virtual void process_music ();
virtual void initialize ();
virtual void process_acknowledged_grobs ();
virtual void finalize ();
-public:
- Protected_scm last_keysig_;
-
- /*
- Urgh. Since the accidentals depend on lots of variables, we have to
- store all information before we can really create the accidentals.
- */
+ virtual void derived_mark () const;
+public:
+ SCM last_keysig_; // ugh.
+
+ /* Urgh. Since the accidentals depend on lots of variables, we have
+ to store all information before we can really create the
+ accidentals. */
Link_array<Grob> left_objects_;
Link_array<Grob> right_objects_;
- Grob * accidental_placement_;
+ Grob *accidental_placement_;
- /*
- The next
- */
Array<Accidental_entry> accidentals_;
- Link_array<Grob> ties_;
+ Link_array<Spanner> ties_;
};
+/*
+ TODO:
+
+ ugh, it is not clear what properties are mutable and which
+ aren't. eg. localKeySignature is changed at runtime, which means
+ that references in grobs should always store ly_deep_copy ()s of
+ those.
+ */
+
static void
-set_property_on_children (Context * trans, const char * sym, SCM val)
+set_property_on_children (Context *trans, char const *sym, SCM val)
{
- trans->set_property (sym, val);
- for (SCM p = trans->context_list_; gh_pair_p (p); p = ly_cdr(p))
+ trans->set_property (sym, ly_deep_copy (val));
+ for (SCM p = trans->children_contexts (); scm_is_pair (p); p = scm_cdr (p))
{
- Context *trg = unsmob_context (ly_car (p));
- set_property_on_children(trg, sym, ly_deep_copy(val));
+ Context *trg = unsmob_context (scm_car (p));
+ set_property_on_children (trg, sym, ly_deep_copy (val));
}
}
}
void
-Accidental_engraver::initialize ()
+Accidental_engraver::derived_mark () const
+{
+ scm_gc_mark (last_keysig_);
+}
+
+void
+Accidental_engraver::update_local_key_signature ()
{
last_keysig_ = get_property ("keySignature");
+ set_property_on_children (context (), "localKeySignature", last_keysig_);
+
+ Context *trans = context ()->get_parent_context ();
- Context * trans_ = daddy_context_;
- while (trans_)
+ /* Huh. Don't understand what this is good for. --hwn. */
+ while (trans && trans->where_defined (ly_symbol2scm ("localKeySignature")))
{
- trans_ -> set_property ("localKeySignature",
- ly_deep_copy (last_keysig_));
- trans_ = trans_->daddy_context_;
+ trans->set_property ("localKeySignature", ly_deep_copy (last_keysig_));
+ trans = trans->get_parent_context ();
}
- set_property_on_children (daddy_context_,"localKeySignature", last_keysig_);
}
-/*
+void
+Accidental_engraver::initialize ()
+{
+ update_local_key_signature ();
+}
-calculates the number of accidentals on basis of the current local key sig
- (passed as argument)
- Returns number of accidentals (0, 1 or 2).
- Negative (-1 or -2) if accidental has changed.
-*/
+/** Calculate the number of accidentals on basis of the current local key
+ sig (passed as argument)
+
+ * First check step+octave (taking into account barnumbers if necessary).
+
+ * Then check the global signature (only step).
+
+ Return number of accidentals (0, 1 or 2). */
+
+static bool
+recent_enough (int bar_number, SCM alteration_def, SCM laziness)
+{
+ if (scm_is_number (alteration_def)
+ || laziness== SCM_BOOL_T)
+ return true;
+
+ return (bar_number <= scm_to_int (scm_cdr (alteration_def)) + scm_to_int (laziness));
+}
+
static int
-number_accidentals_from_sig (SCM sig, Music *, Pitch *pitch, SCM curbarnum, SCM lazyness,
- bool ignore_octave_b)
+extract_alteration (SCM alteration_def)
{
- int n = pitch->get_notename ();
- int o = pitch->get_octave();
- int a = pitch->get_alteration ();
- int curbarnum_i = gh_scm2int (curbarnum);
- int accbarnum_i = 0;
-
- SCM prev;
- if (ignore_octave_b)
- prev = ly_assoc_cdr (scm_int2num (n), sig);
+ if (scm_is_number (alteration_def))
+ return scm_to_int (alteration_def);
+ else if (scm_is_pair (alteration_def))
+ return scm_to_int (scm_car (alteration_def));
+ else if (alteration_def == SCM_BOOL_F)
+ return 0;
else
- prev = scm_assoc (gh_cons (scm_int2num (o), scm_int2num (n)), sig);
+ assert (0);
+ return 0;
+}
- /* should really be true unless prev == SCM_BOOL_F */
- if (gh_pair_p (prev) && gh_pair_p (ly_cdr (prev)))
- {
- accbarnum_i = gh_scm2int (ly_cddr (prev));
- prev = gh_cons (ly_car (prev), ly_cadr (prev));
- }
-
- /* If an accidental was not found or the accidental was too old */
- if (prev == SCM_BOOL_F ||
- (gh_number_p (lazyness) && curbarnum_i > accbarnum_i + gh_scm2int (lazyness)))
- prev = scm_assoc (scm_int2num (n), sig);
+bool
+is_tied (SCM alteration_def)
+{
+ return (alteration_def == SCM_BOOL_T)
+ || (scm_is_pair (alteration_def) && scm_car (alteration_def) == SCM_BOOL_T);
+}
+static int
+number_accidentals_from_sig (bool *different, SCM sig, Pitch *pitch,
+ int bar_number, SCM laziness, bool ignore_octave)
+{
+ int n = pitch->get_notename ();
+ int o = pitch->get_octave ();
- SCM prev_acc = (prev == SCM_BOOL_F) ? scm_int2num (0) : ly_cdr (prev);
+ SCM previous_alteration = SCM_BOOL_F;
- int p = gh_number_p (prev_acc) ? gh_scm2int (prev_acc) : 0;
- int num;
- if (a == p && gh_number_p (prev_acc))
- num = 0;
- else if ( (abs (a)<abs (p) || p*a<0) && a != 0 )
- num = 2;
- else
- num = 1;
+ SCM from_same_octave = ly_assoc_get (scm_cons (scm_int2num (o),
+ scm_int2num (n)), sig, SCM_BOOL_F);
+ SCM from_key_signature = ly_assoc_get (scm_int2num (n), sig, SCM_BOOL_F);
+ SCM from_other_octaves = SCM_BOOL_F;
+ for (SCM s = sig ; scm_is_pair (s); s = scm_cdr (s))
+ {
+ SCM entry = scm_car (s);
+ if (scm_is_pair (scm_car (entry))
+ && scm_cdar (entry) == scm_int2num (n))
+ from_other_octaves = scm_cdr (entry);
+ }
+
+
+ if (from_same_octave != SCM_BOOL_F
+ && recent_enough (bar_number, from_same_octave, laziness))
+ {
+ previous_alteration = from_same_octave;
+ }
+ else if (ignore_octave
+ && from_other_octaves != SCM_BOOL_F
+ && recent_enough (bar_number, from_other_octaves, laziness))
+ {
+ previous_alteration = from_other_octaves;
+ }
+ else if (from_key_signature != SCM_BOOL_F)
+ {
+ previous_alteration = from_key_signature;
+ }
- return a == p ? num : -num;
+ int num = 1;
+ if (is_tied (previous_alteration))
+ {
+ num = 1;
+ *different = true;
+ }
+ else
+ {
+ int prev = extract_alteration (previous_alteration);
+ int alter = pitch->get_alteration ();
+
+ if (alter == prev)
+ num = 0;
+ else if ((abs (alter) < abs (prev) || prev*alter < 0) && alter != 0)
+ num = 2;
+ *different = (alter != prev);
+ }
+ return num;
}
static int
-number_accidentals (Music * note, Pitch *pitch, Context * origin,
- SCM accidentals, SCM curbarnum)
+number_accidentals (bool *different,
+ Pitch *pitch, Context *origin,
+ SCM accidentals, int bar_number)
{
int number = 0;
- bool diff = false;
- if (gh_pair_p (accidentals) && !gh_symbol_p (ly_car (accidentals)))
+ *different = false;
+ if (scm_is_pair (accidentals) && !scm_is_symbol (scm_car (accidentals)))
warning (_f ("Accidental typesetting list must begin with context-name: %s",
- ly_scm2string (ly_car (accidentals)).to_str0 ()));
+ ly_scm2string (scm_car (accidentals)).to_str0 ()));
- for (; gh_pair_p (accidentals) && origin; accidentals = gh_cdr (accidentals))
+ for (; scm_is_pair (accidentals) && origin;
+ accidentals = scm_cdr (accidentals))
{
// If pair then it is a new accidentals typesetting rule to be checked
- SCM rule = gh_car (accidentals);
- if (gh_pair_p (rule))
+ SCM rule = scm_car (accidentals);
+ if (scm_is_pair (rule))
{
- SCM type = gh_car (rule);
- SCM lazyness = gh_cdr (rule);
+ SCM type = scm_car (rule);
+ SCM laziness = scm_cdr (rule);
SCM localsig = origin->get_property ("localKeySignature");
bool same_octave_b =
- gh_eq_p (ly_symbol2scm ("same-octave"), type);
+ scm_is_eq (ly_symbol2scm ("same-octave"), type);
bool any_octave_b =
- gh_eq_p (ly_symbol2scm ("any-octave"), type);
+ scm_is_eq (ly_symbol2scm ("any-octave"), type);
if (same_octave_b || any_octave_b)
{
+ bool d = false;
int n = number_accidentals_from_sig
- (localsig, note, pitch, curbarnum, lazyness, any_octave_b);
- diff = diff || (n < 0);
- number = max (number, abs (n));
+ (&d, localsig, pitch, bar_number, laziness, any_octave_b);
+ *different = *different || d;
+ number = max (number, n);
}
else
- warning (_f ("unknown accidental typesetting: %s. Ignored",
+ warning (_f ("ignoring unknown accidental: %s",
ly_symbol2string (type).to_str0 ()));
}
/*
if symbol then it is a context name. Scan parent contexts to find it.
*/
- else if (gh_symbol_p (rule))
+ else if (scm_is_symbol (rule))
{
- Context * dad = origin;
+ Context *dad = origin;
while (dad && !dad->is_alias (rule))
- dad = dad->daddy_context_;
+ dad = dad->get_parent_context ();
if (dad)
origin = dad;
ly_scm2string (rule).to_str0 ()));
}
- return diff ? -number : number;
+ return number;
+}
+
+int
+Accidental_engraver::get_bar_number ()
+{
+ SCM barnum = get_property ("currentBarNumber");
+ SCM smp = get_property ("measurePosition");
+
+ int bn = robust_scm2int (barnum, 0);
+
+ Moment mp = robust_scm2moment (smp, Moment (0));
+ if (mp.main_part_ < Rational (0))
+ bn--;
+
+ return bn;
}
void
Accidental_engraver::process_acknowledged_grobs ()
{
- if (accidentals_.size () && !accidentals_.top().done_)
+ if (accidentals_.size () && !accidentals_.top ().done_)
{
- //SCM localsig = get_property ("localKeySignature");
SCM accidentals = get_property ("autoAccidentals");
SCM cautionaries = get_property ("autoCautionaries");
- SCM barnum = get_property ("currentBarNumber");
- SCM smp = get_property("measurePosition");
- Moment mp = (unsmob_moment (smp)) ? *unsmob_moment (smp) : Moment (0);
- if(mp.main_part_<Rational(0) && gh_number_p(barnum)) barnum = scm_int2num(gh_scm2int(barnum)-1);
+ int barnum = get_bar_number ();
+
bool extra_natural_b = get_property ("extraNatural") == SCM_BOOL_T;
- for (int i = 0; i < accidentals_.size (); i++)
+ for (int i = 0; i < accidentals_.size (); i++)
{
if (accidentals_[i].done_ )
continue;
accidentals_[i].done_ = true;
- Grob * support = accidentals_[i].head_;
- Music * note = accidentals_[i].melodic_;
- Context * origin = accidentals_[i].origin_;
+ Grob *support = accidentals_[i].head_;
+ Music *note = accidentals_[i].melodic_;
+ Context *origin = accidentals_[i].origin_;
- Pitch * pitch = unsmob_pitch (note->get_mus_property ("pitch"));
+ Pitch *pitch = unsmob_pitch (note->get_property ("pitch"));
if (!pitch)
continue;
+
+ bool different = false;
+ bool different_caut = false;
- int num = number_accidentals (note, pitch, origin, accidentals, barnum);
- int num_caut = number_accidentals (note, pitch, origin, cautionaries, barnum);
- bool cautionary = to_boolean (note->get_mus_property ("cautionary"));
+ int num = number_accidentals (&different,
+ pitch, origin,
+ accidentals, barnum);
+ int num_caut = number_accidentals (&different_caut,
+ pitch, origin,
+ cautionaries, barnum);
+
+ bool cautionary = to_boolean (note->get_property ("cautionary"));
- if (abs (num_caut) > abs (num))
+ if (num_caut > num)
{
num = num_caut;
+ different = different_caut;
cautionary = true;
}
- if(num==0 && to_boolean (note->get_mus_property ("force-accidental")))
- num=1;
+ if (num == 0 && to_boolean (note->get_property ("force-accidental")))
+ num = 1;
- bool different = num < 0;
- num = abs (num);
-
- /* See if there's a tie that makes the accidental disappear */
- Grob *tie_break_reminder = 0;
- bool tie_changes = false;
- for (int j = 0; j < ties_.size (); j++)
- if (support == Tie::head (ties_[j], RIGHT))
- {
- tie_changes = different;
- if (different)
- tie_break_reminder = ties_[j];
- break;
- }
+ /*
+ Can not look for ties: it's not guaranteed that they reach
+ us before the notes
+ */
+
if (num)
{
/*
level, so that we get the property settings for
Accidental from the respective Voice.
*/
- Grob * a = make_item_from_properties (origin,
- ly_symbol2scm ("Accidental"));
+ Grob *a
+ = make_item_from_properties (accidentals_[i].origin_trans_,
+ ly_symbol2scm ("Accidental"),
+ note->self_scm ());
a->set_parent (support, Y_AXIS);
if (!accidental_placement_)
- {
- accidental_placement_ = make_item ("AccidentalPlacement");
- announce_grob (accidental_placement_, a->self_scm());
- }
-
+ accidental_placement_ = make_item ("AccidentalPlacement",
+ a->self_scm ());
Accidental_placement::add_accidental (accidental_placement_, a);
- announce_grob (a, SCM_EOL);
-
-
- SCM accs = gh_cons (scm_int2num (pitch->get_alteration ()), SCM_EOL);
+ SCM accs = scm_cons (scm_int2num (pitch->get_alteration ()),
+ SCM_EOL);
if (num == 2 && extra_natural_b)
- accs = gh_cons (scm_int2num (0), accs);
-
- /* TODO:
+ accs = scm_cons (scm_int2num (0), accs);
- add cautionary option in accidental.
- */
+ /* TODO: add cautionary option in accidental. */
if (cautionary)
- {
- a->set_grob_property ("cautionary", SCM_BOOL_T);
- }
-
- if (tie_break_reminder)
- {
- // TODO.
- a->set_grob_property ("tie", tie_break_reminder->self_scm());
- }
-
+ a->set_property ("cautionary", SCM_BOOL_T);
- support->set_grob_property ("accidental-grob", a->self_scm ());
+ support->set_property ("accidental-grob", a->self_scm ());
- a->set_grob_property ("accidentals", accs);
+ a->set_property ("accidentals", accs);
accidentals_[i].accidental_ = a;
/*
for (int i = 0; i < right_objects_.size (); i++)
Side_position_interface::add_support (a, right_objects_[i]);
}
-
-
- /*
- We should not record the accidental if it is the first
- note and it is tied from the previous measure.
-
- Checking whether it is tied also works mostly, but will it
- always do the correct thing?
- */
-
-
- int n = pitch->get_notename ();
- int o = pitch->get_octave ();
- int a = pitch->get_alteration ();
- SCM on_s = gh_cons (scm_int2num (o), scm_int2num (n));
-
- while (origin)
- {
- /*
- huh? we set props all the way to the top?
- */
- SCM localsig = origin->get_property ("localKeySignature");
- bool change = false;
- if (tie_changes)
- {
- /*
- Remember an alteration that is different both from
- that of the tied note and of the key signature.
- */
- localsig = ly_assoc_front_x
- (localsig, on_s, gh_cons (SCM_BOOL_T, barnum));
-
- change = true;
- }
- else
- {
- /*
- not really really correct if there are more than one
- noteheads with the same notename.
- */
- localsig = ly_assoc_front_x
- (localsig, on_s, gh_cons (scm_int2num (a), barnum));
-
- change = true;
- }
-
- if (change)
- origin->set_property ("localKeySignature", localsig);
- origin = origin->daddy_context_;
- }
}
}
}
void
Accidental_engraver::finalize ()
{
- /*
- Must reset, since Accidental_engraver is GCd.
- */
last_keysig_ = SCM_EOL;
}
void
Accidental_engraver::stop_translation_timestep ()
{
- for (int i = 0; i < accidentals_.size(); i++)
+ for (int j = ties_.size (); j--;)
{
- Grob *a = accidentals_[i].accidental_;
- if (a)
+ Grob *r = Tie::head (ties_[j], RIGHT);
+ for (int i = accidentals_.size (); i--;)
+ if (accidentals_[i].head_ == r)
+ {
+ if (Grob *g = accidentals_[i].accidental_)
+ {
+ g->set_property ("tie", ties_[j]->self_scm ());
+ accidentals_[i].tied_ = true;
+ }
+ ties_.del (j);
+ break;
+ }
+ }
+
+ for (int i = accidentals_.size (); i--;)
+ {
+ int barnum = get_bar_number ();
+
+ Music *note = accidentals_[i].melodic_;
+ Context * origin = accidentals_[i].origin_;
+
+ Pitch *pitch = unsmob_pitch (note->get_property ("pitch"));
+ if (!pitch)
+ continue;
+
+ int n = pitch->get_notename ();
+ int o = pitch->get_octave ();
+ int a = pitch->get_alteration ();
+ SCM key = scm_cons (scm_int2num (o), scm_int2num (n));
+
+ while (origin
+ && origin->where_defined (ly_symbol2scm ("localKeySignature")))
{
- typeset_grob (a);
+ /*
+ huh? we set props all the way to the top?
+ */
+ SCM localsig = origin->get_property ("localKeySignature");
+ bool change = false;
+ if (accidentals_[i].tied_)
+ {
+ /*
+ Remember an alteration that is different both from
+ that of the tied note and of the key signature.
+ */
+ localsig = ly_assoc_front_x
+ (localsig, key, scm_cons (SCM_BOOL_T, scm_int2num (barnum)));
+
+ change = true;
+ }
+ else
+ {
+ /*
+ not really really correct if there are more than one
+ noteheads with the same notename.
+ */
+ localsig = ly_assoc_front_x (localsig, key,
+ scm_cons (scm_int2num (a),
+ scm_int2num (barnum)));
+ change = true;
+ }
+
+ if (change)
+ origin->set_property ("localKeySignature", localsig);
+
+ origin = origin->get_parent_context ();
}
}
- if (accidental_placement_)
- typeset_grob(accidental_placement_);
- accidental_placement_ = 00;
-
- accidentals_.clear();
+ accidental_placement_ = 0;
+ accidentals_.clear ();
left_objects_.clear ();
right_objects_.clear ();
- ties_.clear ();
}
void
Accidental_engraver::acknowledge_grob (Grob_info info)
{
- Music * note = info.music_cause ();
+ Music *note = info.music_cause ();
if (note
&& note->is_mus_type ("note-event")
- && Rhythmic_head::has_interface (info.grob_)
- && !gh_equal_p (info.grob_->get_grob_property ("style"), ly_symbol2scm ("harmonic"))
- )
+ && Rhythmic_head::has_interface (info.grob_))
{
- Accidental_entry entry ;
- entry.head_ = info.grob_;
- entry.origin_ = info.origin_trans_->daddy_context_;
- entry.melodic_ = note;
+ if (to_boolean ( get_property ("harmonicAccidentals"))
+ || !ly_c_equal_p (info.grob_->get_property ("style"),
+ ly_symbol2scm ("harmonic")))
+ {
+
+ Accidental_entry entry ;
+ entry.head_ = info.grob_;
+ entry.origin_trans_ = dynamic_cast<Engraver*> (info.origin_trans_);
+ entry.origin_ = info.origin_trans_->context ();
+ entry.melodic_ = note;
- accidentals_.push (entry);
+ accidentals_.push (entry);
+ }
}
else if (Tie::has_interface (info.grob_))
- {
- ties_.push (info.grob_);
- }
+ ties_.push (dynamic_cast<Spanner*> (info.grob_));
else if (Arpeggio::has_interface (info.grob_))
- {
- left_objects_.push (info.grob_);
- }
- else if (info.grob_->internal_has_interface (ly_symbol2scm("finger-interface")))
- {
- left_objects_.push (info.grob_);
- }
+ left_objects_.push (info.grob_);
+ else if (info.grob_
+ ->internal_has_interface (ly_symbol2scm ("finger-interface")))
+ left_objects_.push (info.grob_);
}
void
Accidental_engraver::process_music ()
{
SCM sig = get_property ("keySignature");
-
/* Detect key sig changes.
- Update all parents and children
- */
+ Update all parents and children. */
if (last_keysig_ != sig)
- {
- Context * trans_ = daddy_context_;
- while (trans_)
- {
- trans_ -> set_property ("localKeySignature", ly_deep_copy (sig));
- trans_ = trans_->daddy_context_;
- }
- set_property_on_children(daddy_context_,"localKeySignature", sig);
-
- last_keysig_ = sig;
- }
+ update_local_key_signature ();
}
-
-
-
-
ENTER_DESCRIPTION (Accidental_engraver,
- "Make accidentals. Catches note heads, ties and notices key-change "
- "events. This engraver usually lives at Staff level, but "
+ "Make accidentals. "
+ "Catch note heads, ties and notices key-change events. "
+ "This engraver usually lives at Staff level, but "
"reads the settings for Accidental at @code{Voice} level, "
"so you can @code{\\override} them at @code{Voice}. "
,
-
- "Accidental",
- "",
- "finger-interface rhythmic-head-interface tie-interface arpeggio-interface",
- "localKeySignature extraNatural autoAccidentals autoCautionaries",
- "localKeySignature");
+ "Accidental"
+ ,
+ ""
+ ,
+ "arpeggio-interface "
+ "finger-interface "
+ "rhythmic-head-interface "
+ "tie-interface "
+ ,
+ "autoAccidentals "
+ "autoCautionaries "
+ "extraNatural "
+ "harmonicAccidentals "
+ "localKeySignature"
+ ,
+ "localKeySignature"
+ );