<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. Value conforms to data.BOOLEAN.
@arrow.color(optional)Captures the overall color of the arrow. Value conforms to data.COLOR.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color. Value conforms to data.COLOR.
@arrow.shape(optional)Symbol rendered at end of the line. Value conforms to data.LINESTARTENDSYMBOL.
@arrow.size(optional)Holds the relative size of the arrow symbol. Value conforms to data.FONTSIZESCALE.
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
@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. Value conforms to data.ENCLOSURE.
@fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
@fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
@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%. Value conforms to data.FONTSIZE.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
@fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
@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. Value is plain text.
@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. Value conforms to data.HEXNUM.
@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. Value conforms to data.URI.
@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. Value conforms to data.MEASUREMENTSIGNED.
@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. Value is plain text.
@layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
@lform(optional)Describes the style of a line. Value conforms to data.LINEFORM.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
@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. One or two values of datatype a positive integer no smaller than 2, separated by a space.
@lwidth(optional)Width of a line. Value conforms to data.LINEWIDTH.
@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. One or more values from data.URI, separated by spaces.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
@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. Value conforms to data.MEASUREMENTSIGNED.
@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. Value is a valid xml:id.
(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. Value is a valid xml:id.
(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. Value is plain text.
(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. One or more values of datatype NMTOKEN, separated by spaces.
(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. One or more values of datatype positiveInteger, separated by spaces.
(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. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes for identifying the staff 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. One or more values of datatype positiveInteger, separated by spaces.
(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. Value conforms to data.BEAT.
(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. Value conforms to data.URI.
(MEI.visual) Visual domain attributes.
@arrow(optional)Indicates if an arrowhead is to be drawn as part of the arpeggiation symbol. Value conforms to data.BOOLEAN.
@arrow.shape(optional)Symbol rendered at end of the line. Value conforms to data.LINESTARTENDSYMBOL.
@arrow.size(optional)Holds the relative size of the arrow symbol. Value conforms to data.FONTSIZESCALE.
@arrow.color(optional)Captures the overall color of the arrow. Value conforms to data.COLOR.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color. Value conforms to data.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. Value conforms to data.COLOR.
(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. Value conforms to data.ENCLOSURE.
(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. Value conforms to data.URI.
(MEI.externalsymbols) Attributes that specify names or values taken from an external symbol authority.
@glyph.name(optional)Glyph name. Value is plain text.
@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. Value conforms to data.HEXNUM.
(MEI.shared) Attributes that record the basic visual rendition of lines.
@lform(optional)Describes the style of a line. Value conforms to data.LINEFORM.
@lwidth(optional)Width of a line. Value conforms to data.LINEWIDTH.
@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. One or two values of datatype a positive integer no smaller than 2, separated by a space.
(MEI.shared) Typographical attributes.
@fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
@fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
@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%. Value conforms to data.FONTSIZE.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
@fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
(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. Value conforms to data.MEASUREMENTSIGNED.
(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. Value conforms to data.MEASUREMENTSIGNED.
@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. Value is plain text.
@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. Value conforms to data.HEXNUM.
@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. Value conforms to data.URI.
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
@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. Value conforms to data.ENCLOSURE.
@fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
@fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
@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%. Value conforms to data.FONTSIZE.
@fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
@fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
@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. Value conforms to data.MEASUREMENTSIGNED.
@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. Value is plain text.
@layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
@letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
@lform(optional)Describes the style of a line. Value conforms to data.LINEFORM.
@lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
@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. One or two values of datatype a positive integer no smaller than 2, separated by a space.
@lwidth(optional)Width of a line. Value conforms to data.LINEWIDTH.
@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. One or more values from data.URI, separated by spaces.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
@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. Value conforms to data.MEASUREMENTSIGNED.
@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. Value is a valid xml:id.
@arrow(optional)Indicates if an arrowhead is to be drawn as part of the arpeggiation symbol. Value conforms to data.BOOLEAN.
@arrow.color(optional)Captures the overall color of the arrow. Value conforms to data.COLOR.
@arrow.fillcolor(optional)Captures the fill color of the arrow if different from the line color. Value conforms to data.COLOR.
@arrow.shape(optional)Symbol rendered at end of the line. Value conforms to data.LINESTARTENDSYMBOL.
@arrow.size(optional)Holds the relative size of the arrow symbol. Value conforms to data.FONTSIZESCALE.
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.
<measure>Unit of musical time consisting of a fixed number of note values of a given type, as determined by the prevailing meter, and delimited in musical notation by bar lines.
<measure>Unit of musical time consisting of a fixed number of note values of a given type, as determined by the prevailing meter, and delimited in musical notation by bar lines.
May Contain
(<arpeg> may not have child elements)
Remarks

The modern arpeggiation symbol is a vertical 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.

Declaration
<elementSpec 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 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 <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>
</remarks>
</elementSpec>