The measure repeat object
Type: Dictionary
This encodes a simile marking, which means "repeat all music in the previous X measures."
If a part-measure contains this marking, then generally its sequence content should be empty. (There is no need to encode the repeated music again.) But in some cases, published music does use a simile marking and notation in the same bar; in that case, encode both the measure repeat and the sequence content.
For a measure repeat that lasts more than one bar ("number" > 1), note that only the first bar should encode the measure repeat. Subsequent bars do not encode any information about the measure repeat.
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
| measure repeat counter | No | Encodes a counter that should be displayed with the measure repeat glyph. Traditionally this is used to help musicians keep track of the current measure repeat iteration. | |
| boolean | No | Whether a number is displayed above the measure repeat glyph. If not provided, consuming applications should determine this according to their own algorithms and convention. The displayed number should equal the value of "number". | |
| measure repeat count | Yes | The number of measures to repeat. | |
| staff position | No | If provided, this specifies the vertical position of the measure repeat glyph on the staff. If not provided, the glyph should be positioned automatically according to convention. Generally this is value 0 (the middle staff line). This vertical position is the "origin point" from which the SMuFL glyph is drawn. |
Plus globally available attributes: _c, _x, id
Parent objects
This object is used by the following parent objects:
- part measure: "measureRepeat"
Examples
This object is used in the following examples: