Next: , Previous: Staff symbol, Up: Staff notation



5.3.2 Key signature

The key signature indicates the tonality in which a piece is played. It is denoted by a set of alterations (flats or sharps) at the start of the staff.

Setting or changing the key signature is done with the \key command

\key pitch type

Here, type should be \major or \minor to get pitch-major or pitch-minor, respectively. The standard mode names \ionian, \locrian, \aeolian, \mixolydian, \lydian, \phrygian, and \dorian are also defined.

This command sets the context property Staff (lilypond-internals) .keySignature. Non-standard key signatures can be specified by setting this property directly.

A natural sign is printed to cancel any previous accidentals. This can be suppressed by setting the Staff.printKeyCancellation property.

     {
       \key d \major
       a b cis d
       \key g \minor
       a bes c d
       \set Staff.printKeyCancellation = ##f
       \key d \major
       a b cis d
       \key g \minor
       a bes c d
     }

[image of music]

Accidentals and key signatures often confuse new users, because unaltered notes get natural signs depending on the key signature. For more information, see More about pitches.

See also

Program reference: KeyChangeEvent (lilypond-internals) , KeyCancellation (lilypond-internals) and KeySignature (lilypond-internals) .

Read comments on this page, or add one.

This page is for LilyPond-2.5.11 (development-branch).

Report errors to <bug-lilypond@gnu.org>.

Other languages: English.
Using automatic language selection.