The accent dynamic object
Type: Dictionary
An accent dynamic is for dynamics that are temporary accents on a single beat, such as sfz (sforzando). It's composed of "value" and "residualValue".
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
The string "accent"
|
Yes | ||
| dynamic value | Yes | The value of the initial attack (the "f" in "sfz"). See residualValue for the dynamic that applies afterward. | |
| rhythmic position | Yes | The rhythmic position at which this dynamic group starts. | |
| dynamic prefix | No | The prefix for the dynamic. For example, for a "sfz" dynamic, the prefix is "s". If not provided, the default is "s". |
|
| dynamic suffix | No | The suffix for the dynamic. For example, for a "sfz" dynamic, the suffix is "z". If not provided, the default is "z". |
|
| dynamic value | No | The dynamic that should be used after the initial accent attack. For example, this is used for "fp" dynamics, which are a bit of a special case meaning "start playing in f, then immediately reduce dynamics to p." This is encoded as {"value": "f", "residualValue": "p"}. |
|
| An array of smufl glyph objects | No | Optional list of SMuFL glyphs to use when displaying this dynamic. If this is provided, consuming applications should use these specific glyphs. If this isn't provided, consuming applications should automatically determine the SMuFL glyphs based on "value", "residualValue", "accentPrefix", and "accentSuffix". |
|
| string | No | Optional text to display before the dynamic marking, such as "più". This is free-form text displayed alongside the marking. It is not related to accentPrefix, which encodes a structural part of an accent marking itself. |
|
| string | No | Optional text to display after the dynamic marking, such as "sub.". This is free-form text displayed alongside the marking. It is not related to accentSuffix, which encodes a structural part of an accent marking itself. |
|
| multi-staff placement | No | Where the dynamic group is positioned, relative to the staff. If not provided, the default value is "auto". |
|
| staff number | No | The staff index to which this dynamic group applies. By default, a dynamic group applies to all staffs in the part. | |
| ID | No | Points to the ID of the directly previous dynamic group, as a hint to rendering engines that this dynamic group and that previous one should be rendered as a single unit. (Typically this means the dynamics and hairpins are drawn at the same vertical position.) There is no limit to the length of a "visuallyContinues" chain. For example, it's perfectly OK for three or four dynamic groups to each define "visuallyContinues" pointing at the previous dynamic group. Encoding this is only strictly necessary if it can't be automatically derived by comparing consecutive dynamic groups' "position" and "end" attributes. Rendering engines are encouraged to determine the visuallyContinues value on their own, if it's not explicitly encoded. |
|
| voice name | No | The voice to which this dynamic group applies. By default, a dynamic group applies to all voices in the part. |
Plus globally available attributes: _c, _x, id
Parent objects
This object is used by the following parent objects:
- part measure: "dynamics"
Examples
This object is used in the following examples: