<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Rests - GNU LilyPond Notation Reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Notation Reference">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Writing-rests.html#Writing-rests" title="Writing rests">
<link rel="next" href="Invisible-rests.html#Invisible-rests" title="Invisible rests">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Rests"></a>
Next: <a rel="next" accesskey="n" href="Invisible-rests.html#Invisible-rests">Invisible rests</a>,
Up: <a rel="up" accesskey="u" href="Writing-rests.html#Writing-rests">Writing rests</a>
<hr>
</div>
<h5 class="subsubsection">1.2.2.1 Rests</h5>
<p><a name="index-rest-472"></a><a name="index-rest_002c-entering-durations-473"></a><a name="index-maxima-474"></a><a name="index-longa-475"></a><a name="index-breve-476"></a>
<a name="index-g_t_005crest-477"></a><a name="index-g_t_005crest-478"></a>
<a name="index-r-479"></a><a name="index-r-480"></a>
<a name="index-g_t_005cmaxima-481"></a><a name="index-g_t_005cmaxima-482"></a>
<a name="index-g_t_005clonga-483"></a><a name="index-g_t_005clonga-484"></a>
<a name="index-g_t_005cbreve-485"></a><a name="index-g_t_005cbreve-486"></a>
<p>Rests are entered like notes with the note name <code>r</code>.
Durations longer than a whole rest use the predefined
commands shown:
<!-- \time 16/1 is used to avoid spurious bar lines -->
<!-- and long tracts of empty measures -->
<blockquote>
<pre class="verbatim">
\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
}
</pre>
<p>
<a href="../48/lily-b04c1a14.ly">
<img align="middle"
border="0" src="../48/lily-b04c1a14.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><a name="index-rest_002c-multi_002dmeasure-487"></a><a name="index-rest_002c-whole_002dmeasure-488"></a>
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 <a href="Full-measure-rests.html#Full-measure-rests">Full measure rests</a>.
<p><a name="index-rest_002c-specifying-vertical-position-489"></a>
To explicitly specify a rest's vertical position, write a note
followed by <code>\rest</code>. 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.
<blockquote>
<pre class="verbatim">
a4\rest d4\rest
</pre>
<p>
<a href="../5a/lily-ce439f35.ly">
<img align="middle"
border="0" src="../5a/lily-ce439f35.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p><em>Rest styles</em>
<p>Rests may be used in various styles.
<blockquote>
<pre class="verbatim">
\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
}
</pre>
<p>
<a href="../84/lily-16cddb5e.ly">
<img align="middle"
border="0" src="../84/lily-16cddb5e.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Notation Reference:
<a href="Full-measure-rests.html#Full-measure-rests">Full measure rests</a>.
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Rhythms.html#Rhythms">Rhythms</a>.
<p>Internals Reference:
<a name="index-Rest-490"></a><a href="../lilypond-internals/Rest.html#Rest">Rest</a>.
<p class="noindent">
<h5 class="subsubheading">Known issues and warnings</h5>
<!-- Deliberately duplicated in Durations and Rests. -gp -->
<p>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).
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Invisible-rests.html#Invisible-rests">Invisible rests</a>,
Up: <a rel="up" accesskey="u" href="Writing-rests.html#Writing-rests">Writing rests</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
This page is for LilyPond-2.11.57 (development-branch).
<br>
<address>
Report errors to <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address>
<br>
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome.
</font>
</p>
</div>
<P>
Other languages: <a href="Rests.fr.html">français</a>, <a href="Rests.es.html">español</a>, <a href="Rests.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
