The <rest> element
Parent element: <note>
The <rest> element indicates notated rests or silences. A <rest> element is usually empty, but placement on the staff can be specified using <display-step> and <display-octave> elements.
The vertical position of the symbol is determined by the “origin point” from which the symbol’s SMuFL glyph is drawn. This is the top of a whole rest, the bottom of a half rest, and the mid-point for other rests. Full-measure rests are no exception, they also follow the same SMuFL symbol positioning.
In the absence of explicitly defined <display-step>, the placement is application-dependent. Typically, the conventional placement will be expected, unless the application adjusts the placement to accommodate situations such as multiple voices.
Content
- <display-step> (Required)
- <display-octave> (Required)
Attributes
| Name | Type | Required?(Default) | Description |
|---|---|---|---|
| measure | yes-no | No | If yes, this indicates this is a complete measure rest. |
| If yes, this indicates this is a complete measure rest. | |||
Examples
This element is used in the following examples:
<barline> with multiple codas<double><except-voice><forward><glissando> (Multiple)<grouping><instrument-change><laughing><link><measure-repeat><multiple-rest><pedal> (Symbols)<principal-voice><rest><rest> and <display-step><slash><tap><tied><voice-direction>Tutorial: Après un rêveTutorial: Percussion