The multi-note tremolo object
Type: Dictionary
This object represents a multi-note tremolo, including all notes within.
Multi-note tremolos are inherently a special case, for two reasons:
- Although a tremolo's events are displayed sequentially, playback should oscillate between the events (hence producing the audible tremolo effect).
- Per convention, a tremolo's events are visually rendered with note values equal to the entire duration of the tremolo.
To account for #2: for each event within a multi-note tremolo, the duration encodes the rhythmic duration of the displayed notehead.
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
| An array of event objects | Yes | The sequence of events within this multi-note tremolo. Typically this will be exactly two events. Each inner event's "duration" must be the duration of the displayed notehead.For example, consider a multi-note tremolo whose total duration equals the duration of a half note and contains two inner events. Each inner event would have a "duration" value of "half". |
|
| note value | No | Optional. The performed duration of an individual event in this multi-note tremolo. Generally this is unnecessary to encode, because it can be automatically calculated from "marks" and "outer". But software may choose to explicitly encode this. |
|
| positive integer | Yes | The number of beams to use in this multi-note tremolo. Must be between 1 and 8, inclusive. | |
| note value quantity | Yes | The duration of this multi-note tremolo with respect to its containing element. This is how much time the tremolo occupies in the sequence in which it is placed. This value's "multiple" must equal the total number of events within the tremolo. (Usually this will be 2.)For example, consider a multi-note tremolo whose total duration equals the duration of a half note and contains two inner events. This would use an outer value of {"multiple": "2", "duration": {"base": "quarter"}}. (Note, per convention, that both inner events would be visually rendered as half notes.) |
|
The string "tremolo"
|
Yes |
Plus globally available attributes: _c, _x, id
Parent objects
This object is used by the following parent objects:
- sequence: "content"
Examples
This object is used in the following examples: