Next: , Up: Displaying pitches


Clef

The clef may be altered. Middle C is shown in every example.

     
     \clef treble
     c2 c
     \clef alto
     c2 c
     \clef tenor
     c2 c
     \clef bass
     c2 c

[image of music]

Other clefs include:

     
     \clef french
     c2 c
     \clef soprano
     c2 c
     \clef mezzosoprano
     c2 c
     \clef baritone
     c2 c
     
     \break
     
     \clef varbaritone
     c2 c
     \clef subbass
     c2 c
     \clef percussion
     c2 c
     \clef tab
     c2 c

[image of music]

Further supported clefs are described under Ancient clefs.

By adding _8 or ^8 to the clef name, the clef is transposed one octave down or up, respectively, and _15 and ^15 transpose by two octaves. The clef name must be enclosed in quotes when it contains underscores or digits.

     
     \clef treble
     c2 c
     \clef "treble_8"
     c2 c
     \clef "bass^15"
     c2 c

[image of music]

Selected Snippets

Tweaking clef properties

The command \clef "treble_8" is equivalent to setting clefGlyph, clefPosition (which controls the vertical position of the clef), middleCPosition and clefOctavation. A clef is printed when any of the properties except middleCPosition are changed.

Note that changing the glyph, the position of the clef, or the octavation does not in itself change the position of subsequent notes on the staff: the position of middle C must also be specified to do this. The positional parameters are relative to the staff center line, positive numbers displacing upwards, counting one for each line and space. The clefOctavation value would normally be set to 7, -7, 15 or -15, but other values are valid.

When a clef change takes place at a line break the new clef symbol is printed at both the end of the previous line and the beginning of the new line by default. If the warning clef at the end of the previous line is not required it can be suppressed by setting the Staff property explicitClefVisibility to the value end-of-line-invisible. The default behavior can be recovered with \unset Staff.explicitClefVisibility.

The following examples show the possibilities when setting these properties manually. On the first line, the manual changes preserve the standard relative positioning of clefs and notes, whereas on the second line, they do not.

     
     {
       % The default treble clef
       c'1
       % The standard bass clef
       \set Staff.clefGlyph = #"clefs.F"
       \set Staff.clefPosition = #2
       \set Staff.middleCPosition = #6
       c'1
       % The baritone clef
       \set Staff.clefGlyph = #"clefs.C"
       \set Staff.clefPosition = #4
       \set Staff.middleCPosition = #4
       c'1
       % The standard choral tenor clef
       \set Staff.clefGlyph = #"clefs.G"
       \set Staff.clefPosition = #-2
       \set Staff.clefOctavation = #-7
       \set Staff.middleCPosition = #1
       c'1
       % A non-standard clef
       \set Staff.clefPosition = #0
       \set Staff.clefOctavation = #0
       \set Staff.middleCPosition = #-4
       c'1 \break
     
       % The following clef changes do not preserve
       % the normal relationship between notes and clefs:
     
       \set Staff.clefGlyph = #"clefs.F"
       \set Staff.clefPosition = #2
       c'1
       \set Staff.clefGlyph = #"clefs.G"
       c'1
       \set Staff.clefGlyph = #"clefs.C"
       c'1
       \set Staff.clefOctavation = #7
       c'1
       \set Staff.clefOctavation = #0
       \set Staff.clefPosition = #0
       c'1
       
       % Here we go back to the normal clef:
     
       \set Staff.middleCPosition = #0
       c'1
     }

[image of music]

See also

Notation Reference: Ancient clefs.

Snippets: Pitches.

Internals Reference: Clef_engraver, Clef, OctavateEight, clef-interface.

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

Report errors to http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.

Your suggestions for the documentation are welcome.

Other languages: français, español, deutsch.