Accidental_engraver - LilyPond program-reference
Description: LilyPond program-reference

Next: Ambitus_engraver, Up: Engravers

#### 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.
`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

This page is for LilyPond-2.8.8 (stable-branch).

Other languages: English.
Using automatic language selection.