The <arpeggiate> element
Parent element: <notations>
The <arpeggiate> element indicates that this note is part of an arpeggiated chord. The length of the sign can be determined from the position attributes for the <arpeggiate> elements used with the top and bottom notes of the arpeggiated chord.
Content
Always empty.
Attributes
| Name | Type | Required? | Description |
|---|---|---|---|
| color | color | No | Indicates the color of an element. |
| default-x | tenths | No | Changes the computation of the default horizontal position. The origin is changed relative to the left-hand side of the note or the musical position within the bar. Positive x is right and negative x is left. This attribute provides higher-resolution positioning data than the <offset> element. Applications reading a MusicXML file that can understand both features should generally rely on this attribute for its greater accuracy. |
| default-y | tenths | No | Changes the computation of the default vertical position. The origin is changed relative to the top line of the staff. Positive y is up and negative y is down. This attribute provides higher-resolution positioning data than the placement attribute. Applications reading a MusicXML file that can understand both attributes should generally rely on this attribute for its greater accuracy. |
| direction | up-down | No | Used if there is an arrow on the arpeggio sign. By default, arpeggios go from the lowest to highest note. |
| id | ID | No | Specifies an ID that is unique to the entire document. |
| number | number-level | No | Used to distinguish between two simultaneous chords arpeggiated separately (different numbers) or together (same number). |
| placement | above-below | No | Indicates whether something is above or below another element, such as a note or a notation. |
| relative-x | tenths | No | Changes the horizontal position relative to the default position, either as computed by the individual program, or as overridden by the default-x attribute. Positive x is right and negative x is left. It should be interpreted in the context of the <offset> element or directive attribute if those are present. |
| relative-y | tenths | No | Changes the vertical position relative to the default position, either as computed by the individual program, or as overridden by the default-y attribute. Positive y is up and negative y is down. It should be interpreted in the context of the placement attribute if that is present. |
| unbroken | yes-no | No | If yes, indicates that the arpeggio continues onto another staff within the part. This serves as a hint to applications and is not required for cross-staff arpeggios. |
Examples
This element is used in the following examples: