The multi-note tremolo object | MNX specification

# 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:

1. Although a tremolo's events are displayed sequentially, playback should oscillate between the events (hence producing the audible tremolo effect).
2. 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
--- | --- | --- | ---
content | 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"`.
individualDuration | 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.
marks | positive integer | Yes | The number of beams to use in this multi-note tremolo. Must be between 1 and 8, inclusive.
outer | 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.)
type | 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:

Tremolos (multi-note)