The relative dynamic object
Type: Dictionary
A relative dynamic is one whose value is meant to be interpreted relatively, like più p ("quieter").
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
The string "relative"
|
Yes | ||
| relative dynamic value | Yes | ||
| dynamic value | No | An optional dynamic value. For example, in "più p", the "value" is p. | |
| rhythmic position | Yes | The rhythmic position at which this dynamic group starts. | |
| An array of smufl glyph objects | No | Optional list of SMuFL glyphs to use when displaying the dynamic in "value". 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". |
|
| string | No | Optional text to display before the dynamic marking, such as "più". This is free-form text displayed alongside the marking. |
|
| string | No | Optional text to display after the dynamic marking, such as "sub.". This is free-form text displayed alongside the marking. |
|
| 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"