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 |
---|---|---|---|
style class object | No | An optional style class to use for this object and all child objects. | |
color object | No | An optional color to be used when rendering this object and all child objects. | |
An array of event objects | Yes | ||
grace type object | No | The kind of grace notes to use. The default value is "steal-previous". | |
boolean object | 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 "grace-type". |
|
The string "grace"
|
Yes |
Examples
This object is used in the following examples: