The rhythmic position object
Type: Dictionary
Describes the rhythmic position of a notational object within a bar.
Keys
| Name | Type | Required? | Description |
|---|---|---|---|
| string | No | An optional comment. This serves a similar function as XML or HTML comments. | |
| An array of integer (unsigned) objects | Yes | The rhythmic position, as a fraction. For example, "the position a quarter note's duration into a bar" would be encoded as [1, 4]. | |
| integer (unsigned) | No | This allows targeting of grace notes. Given that a grace note has the same rhythmic position as its target (non-grace) note, it's necessary to provide a way to distinguish between a target note and a grace note. And in the case of multiple grace notes, it's necessary to provide a way to target a specific one of them. The graceIndex value is a non-negative integer that counts "backwards" from the target note. The target note gets graceIndex=0. The right-most grace note gets graceIndex=1. Then, going leftward from the right-most grace note, the graceIndex increments by 1 for each additional grace note. If graceIndex isn't specified, the position should be interpreted as before all grace notes. |
|
| ID | No |
Parent objects
This object is used by the following parent objects:
- dynamic: "position"
- fine: "location"
- jump: "location"
- measure rhythmic position: "position"
- ottava: "position"
- positioned clef: "position"
- segno: "location"
- tempo: "location"
Examples
This object is used in the following examples: