Accidental_engraver
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 Voice
level, so you can \override
them at Voice
.
Properties (read)
autoAccidentals
(list)- List of
different ways to typeset an accidental.
For determining when to print an accidental, several different rules
are tried. The rule that gives the highest number of accidentals is
used. Each rule consists of
- context:
- In which context is the rule applied. For example, if
context is Score then all staves share
accidentals, and if context is Staff then all
voices in the same staff share accidentals, but staves do not.
- octavation:
- Whether the accidental changes all octaves or only the current
octave. Valid choices are
- `same-octave:'
- This is the default algorithm. Accidentals are typeset if the note changes
the accidental of that note in that octave. Accidentals lasts to the end of the measure
and then as many measures as specified in the value. I.e. 1 means to the end
of next measure, -1 means to the end of previous measure (that is: no duration at all), etc. #t means forever.
- `any-octave:'
- Accidentals are typeset if the note is different from
the previous note on the same pitch in any octave. The value has same meaning as in
same-octave.
- laziness
-
Over how many bar lines the accidental lasts.
If laziness is
-1
then the accidental is forgotten
immediately, and if laziness is #t
then the accidental
lasts forever.
autoCautionaries
(list)- List similar to
autoAccidentals
, but it controls cautionary accidentals rather than
normal ones. Both lists are tried, and the one giving the most accidentals
wins. In case of draw, a normal accidental is typeset.
internalBarNumber
(integer)- Contains the current barnumber. This property is used for internal timekeeping, among others by the
Accidental_engraver
.
extraNatural
(boolean)- Whether to typeset an
extra natural sign before accidentals changing from a non-natural to
another non-natural.
harmonicAccidentals
(boolean)- If set, harmonic notes in chords
get accidentals.
localKeySignature
(list)- the key signature at this point in the
measure. The format is the same as for keySignature, but can also
contain ((octave . name) . (alter . barnumber))
pairs. It is reset at every bar line.
Properties (write)
localKeySignature
(list)- the key signature at this point in the
measure. The format is the same as for keySignature, but can also
contain ((octave . name) . (alter . barnumber))
pairs. It is reset at every bar line.
This engraver creates the following layout objects:
Accidental and AccidentalSuggestion.
Accidental_engraver
is part of contexts: GregorianTranscriptionStaff, MensuralStaff, Staff and VaticanaStaff