<arpeg>

(arpeggiation) – Indicates that the notes of a chord are to be performed successively rather than simultaneously, usually from lowest to highest. Sometimes called a "roll".
Module
Attributes
@arrow, @arrow.color, @arrow.fillcolor, @arrow.shape, @arrow.size, @color, @enclose, @fontfam, @fontname, @fontsize, @fontstyle, @fontweight, @glyph.auth, @glyph.name, @glyph.num, @glyph.uri, @ho, @label, @layer, @letterspacing, @lform, @lineheight, @lsegs, @lwidth, @order, @plist, @staff, @startid, @tstamp, @type, @vo, @xml:id
@arrow(optional)Indicates if an arrowhead is to be drawn as part of the arpeggiation symbol.
@arrow.color(optional)Captures the overall color of the arrow.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color.
@arrow.shape(optional)Symbol rendered at end of the line.
@arrow.size(optional)Holds the relative size of the arrow symbol.
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.
@enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14.
@fontfam(optional)Contains the name of a font-family.
@fontname(optional)Holds the name of a font.
@fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal.
@fontweight(optional)Used to indicate bold type.
@glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
@glyph.name(optional)Glyph name.
@glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF.
@glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element.
@ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
@label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content.
@layer(optional)Identifies the layer to which a feature applies.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property.
@lform(optional)Describes the style of a line.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property.
@lsegs(optional)Describes the number of segments into which a dashed or dotted line may be divided, or the number of "peaks" of a wavy line; a pair of space-separated values (minimum and maximum, respectively) provides a range between which a rendering system-supplied value may fall, while a single value indicates a fixed amount of space; that is, the minimum and maximum values are equal.
@lwidth(optional)Width of a line.
@order(optional)Describes the direction in which an arpeggio is to be performed. Allowed values are: "up" (Lowest to highest pitch.), "down" (Highest to lowest pitch.), "nonarp" (Non-arpeggiated style (usually rendered with a preceding bracket instead of a wavy line).)
@plist(optional)When the target attribute is present, plist identifies the active participants; that is, those entities pointed "from", in a relationship with the specified target(s). When the target attribute is not present, it identifies participants in a mutual relationship.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies.
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
@xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value.
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that uniquely identify an element.
@xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value.
(MEI.shared)
@label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content.
(MEI.shared) Attributes which can be used to classify features.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
(MEI.cmn) Logical domain attributes.
@order(optional)Describes the direction in which an arpeggio is to be performed. Allowed values are: "up" (Lowest to highest pitch.), "down" (Highest to lowest pitch.), "nonarp" (Non-arpeggiated style (usually rendered with a preceding bracket instead of a wavy line).)
(MEI.shared) Attributes shared by events which rely on other events for their existence. For example, a slur/phrase marking must be drawn between or over a group of notes. The slur is therefore a control event.
(MEI.shared) Attributes that identify the layer to which a feature applies.
@layer(optional)Identifies the layer to which a feature applies.
(MEI.shared) Attributes listing the active participants in a user-defined collection.
@plist(optional)When the target attribute is present, plist identifies the active participants; that is, those entities pointed "from", in a relationship with the specified target(s). When the target attribute is not present, it identifies participants in a mutual relationship.
(MEI.shared) Attributes for identifying the staff or staff group associated with the current feature.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable.
(MEI.shared) Attributes that record a time stamp in terms of musical time, , beats[.fractional beat part].
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature.
(MEI.shared) Attributes that identify a relative starting point.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies.
(MEI.visual) Visual domain attributes.
@arrow(optional)Indicates if an arrowhead is to be drawn as part of the arpeggiation symbol.
@arrow.shape(optional)Symbol rendered at end of the line.
@arrow.size(optional)Holds the relative size of the arrow symbol.
@arrow.color(optional)Captures the overall color of the arrow.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color.
(MEI.shared) Visual color attributes.
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.
(MEI.shared) Attributes that capture characters used to enclose symbols having a cautionary or editorial function.
@enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14.
(MEI.externalsymbols) Attributes used to associate MEI features with corresponding glyphs in an externally-defined standard such as SMuFL.
(MEI.externalsymbols) Attributes that point to an external symbol authority.
@glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
@glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element.
(MEI.externalsymbols) Attributes that specify names or values taken from an external symbol authority.
@glyph.name(optional)Glyph name.
@glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF.
(MEI.shared) Attributes that record the basic visual rendition of lines.
@lform(optional)Describes the style of a line.
@lwidth(optional)Width of a line.
@lsegs(optional)Describes the number of segments into which a dashed or dotted line may be divided, or the number of "peaks" of a wavy line; a pair of space-separated values (minimum and maximum, respectively) provides a range between which a rendering system-supplied value may fall, while a single value indicates a fixed amount of space; that is, the minimum and maximum values are equal.
(MEI.shared) Typographical attributes.
@fontfam(optional)Contains the name of a font-family.
@fontname(optional)Holds the name of a font.
@fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal.
@fontweight(optional)Used to indicate bold type.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property.
(MEI.shared) Visual offset attributes. Some items may have their location recorded in terms of offsets from their programmatically-determined location. The ho attribute records the horizontal offset while vo records the vertical. The to attribute holds a timestamp offset, the most common use of which is as an alternative to the ho attribute.
(MEI.shared) Horizontal offset attributes.
@ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
(MEI.shared) Vertical offset attributes.
@vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
@order(optional)Describes the direction in which an arpeggio is to be performed. Allowed values are: "up" (Lowest to highest pitch.), "down" (Highest to lowest pitch.), "nonarp" (Non-arpeggiated style (usually rendered with a preceding bracket instead of a wavy line).)
@glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
@glyph.name(optional)Glyph name.
@glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF.
@glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of @glyph.name or @glyph.num is taken, or the textual content of the element.
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.
@enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14.
@fontfam(optional)Contains the name of a font-family.
@fontname(optional)Holds the name of a font.
@fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal.
@fontweight(optional)Used to indicate bold type.
@ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
@label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content.
@layer(optional)Identifies the layer to which a feature applies.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property.
@lform(optional)Describes the style of a line.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property.
@lsegs(optional)Describes the number of segments into which a dashed or dotted line may be divided, or the number of "peaks" of a wavy line; a pair of space-separated values (minimum and maximum, respectively) provides a range between which a rendering system-supplied value may fall, while a single value indicates a fixed amount of space; that is, the minimum and maximum values are equal.
@lwidth(optional)Width of a line.
@plist(optional)When the target attribute is present, plist identifies the active participants; that is, those entities pointed "from", in a relationship with the specified target(s). When the target attribute is not present, it identifies participants in a mutual relationship.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies.
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines.
@xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value.
@arrow(optional)Indicates if an arrowhead is to be drawn as part of the arpeggiation symbol.
@arrow.color(optional)Captures the overall color of the arrow.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color.
@arrow.shape(optional)Symbol rendered at end of the line.
@arrow.size(optional)Holds the relative size of the arrow symbol.
Member of
model.controlEventLike.cmnGroups control events that appear in CMN.
Contained By
(MEI.cmn) Groups control events that appear in CMN.
(MEI.cmn) Groups elements that may appear within a CMN measure.
May Contain
– (<arpeg> may not have child elements)
Remarks

The modern arpeggiation symbol is a vertical, usually wavy line preceding the chord. When the notes of the chord are to be performed from highest to lowest, an arrowhead may be added to the lower end of the line. Even though it is redundant, an arrowhead is sometimes added to the upper end of the line for the sake of consistency or when the direction of successive arpeggios alternates.

In music for keyboard instruments, sometimes a distinction is made between a single arpeggio in which both hands play successively and simultaneous arpeggios in two hands. In the case of the former, multiple values may be required in the @staff and @layer attributes. Arpeggios that do not cross staves, but still involve more than one layer require multiple values for the @layer attribute.

For arpeggios written as a straight line, which are common in guitar music, @lform takes the value solid. Such arpeggios always have an arrowhead.

Declaration
<elementSpec xmlns="http://www.tei-c.org/ns/1.0" rend="add" ident="arpeg" module="MEI.cmn">
<gloss xml:lang="en">arpeggiation</gloss>
<desc xml:lang="en">Indicates that the notes of a chord are to be performed successively rather than simultaneously, usually from lowest to highest. Sometimes called a "roll".</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.arpeg.log"/>
<memberOf key="att.arpeg.vis"/>
<memberOf key="model.controlEventLike.cmn"/>
</classes>
<content>
<empty/>
</content>
<remarks xml:lang="en">
<p>The modern arpeggiation symbol is a vertical, usually wavy line preceding the chord. When the notes of the chord are to be performed from highest to lowest, an arrowhead may be added to the lower end of the line. Even though it is redundant, an arrowhead is sometimes added to the upper end of the line for the sake of consistency or when the direction of successive arpeggios alternates.</p>
<p>In music for keyboard instruments, sometimes a distinction is made between a single arpeggio in which both hands play successively and simultaneous arpeggios in two hands. In the case of the former, multiple values may be required in the <att>staff</att> and <att>layer</att> attributes. Arpeggios that do not cross staves, but still involve more than one layer require multiple values for the <att>layer</att> attribute.</p>
<p>For arpeggios written as a straight line, which are common in guitar music, <att>lform</att> takes the value
<val>solid</val>
. Such arpeggios always have an arrowhead.</p>
</remarks>
</elementSpec>