The octave shift object
Type: Dictionary
An octave shift, traditionally notated with a marking such as "8va", tells a musician that the affected note(s) are being rendered a number of octaves up or down from their normal appearance on the staff, for sake of readability.
Note: the "pitch" attribute of any affected note should be encoded as the sounded pitch. In other words, the absence or presence of an octave shift does not affect a note's "pitch" attribute; the octave shift only affects the note's graphical display.
Keys:
| Name | Type | Required? | Description |
|---|---|---|---|
| measure location object | Yes | The measure location of the last event that is affected by this direction. This measure location must lie within the same run of measure content as this direction's start position. |
|
| orientation object | No | ||
| staff number object | No | The staff index to which this octave shift applies, if such a designation makes sense. If not provided, the value is inherited from any sequence ancestor that specified it. If no ancestor did so, the consuming software should determine the value automatically according to its own logic. | |
The string "octave-shift"
|
Yes | ||
| octave shift amount object | Yes | The type of octave shift. |
Examples
This object is used in the following examples: