Next: , Up: Writing rests


1.2.2.1 Rests

Rests are entered like notes with the note name r. Durations longer than a whole rest use the predefined commands shown:

     
     \new Staff {
       % These two lines are just to prettify this example
       \time 16/1
       \override Staff.TimeSignature #'stencil = ##f
       % Print a maxima rest, equal to four breves
       r\maxima
       % Print a longa rest, equal to two breves
       r\longa
       % Print a breve rest
       r\breve
       r1 r2 r4 r8 r16 r32 r64 r128
     }

[image of music]

Whole measure rests, centered in the middle of the measure, must be entered as multi-measure rests. They can be used for a single measure as well as many measures and are discussed in Full measure rests.

To explicitly specify a rest's vertical position, write a note followed by \rest. A rest of the duration of the note will be placed at the staff position where the note would appear. This allows for precise manual formatting of polyphonic music, since the automatic rest collision formatter will not move these rests.

     
     a4\rest d4\rest

[image of music]

Selected Snippets

Rest styles

Rests may be used in various styles.

     
     \layout {
       indent = 0.0
       \context {
         \Staff
         \remove "Time_signature_engraver"
       }
     }
     
     \relative c {
       \set Score.timing = ##f
       \override Staff.Rest  #'style = #'mensural
       r\maxima^\markup \typewriter { mensural }
       r\longa r\breve r1 r2 r4 r8 r16 r32 r64 r128 r128
       \bar ""
       
       \override Staff.Rest  #'style = #'neomensural
       r\maxima^\markup \typewriter { neomensural }
       r\longa r\breve r1 r2 r4 r8 r16 r32 r64 r128 r128
       \bar ""
       
       \override Staff.Rest  #'style = #'classical
       r\maxima^\markup \typewriter { classical }
       r\longa r\breve r1 r2 r4 r8 r16 r32 r64 r128 r128
       \bar ""
       
       \override Staff.Rest  #'style = #'default
       r\maxima^\markup \typewriter { default }
       r\longa r\breve r1 r2 r4 r8 r16 r32 r64 r128 r128
     }

[image of music]

See also

Notation Reference: Full measure rests.

Snippets: Rhythms.

Internals Reference: Rest.

Known issues and warnings

There is no fundamental limit to rest durations (both in terms of longest and shortest), but the number of glyphs is limited: there are rests from 128th to maxima (8 x whole).

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.