The grace object

Type: Dictionary

A grace object encodes grace notes. Its "content" contains the note data.

Within "content", each inner event's "value" encodes the visual rhythmic appearance of the grace note — e.g., "/8" for an eighth note.

Any direction content that lacks a location attribute and lives within a grace object is considered to be in alignment with the following event, even though grace notes in the same run technically share the same measure location.

Keys

Name Type Required? Description
class style class No An optional style class to use for this object and all child objects.
color color No An optional color to be used when rendering this object and all child objects.
content An array of event objects Yes
graceType grace type No The kind of grace notes to use. The default value is "stealPrevious".
slash boolean No Whether grace notes are notated with a slash.

The default value (true) specifies a slash, indicating that the grace notes are displayed with a diagonal stroke and are to be performed quickly and not in their notated rhythm. Otherwise, they are performed with the notated note values according to the performance characteristics given by "graceType".
type The string "grace" Yes

Parent objects

This object is used by the following parent objects:

Examples

This object is used in the following examples:

Beams (with inner grace notes), Grace note, Grace notes (beamed)