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:

<arpeggiate>