att.line.vis

Attributes for describing the visual appearance of a line.
Module
Attributes
color, endho, endsym, endsym.size, endto, endvo, form, ho, place, startho, startsym, startsym.size, startto, startvo, to, vo, width, x, x2, y, y2
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.
endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
endsym(optional)Symbol rendered at end of line. Value conforms to data.LINESTARTENDSYMBOL.
endsym.size(optional)Holds the relative size of the line-end symbol. Value conforms to data.FONTSIZESCALE.
endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point. Value conforms to data.TSTAMPOFFSET.
endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
form(optional)Visual form of the line. Value conforms to data.LINEFORM.
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.
place(optional)Captures the placement of the item with respect to the staff with which it is associated. Value conforms to data.STAFFREL.
startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
startsym(optional)Symbol rendered at start of line. Value conforms to data.LINESTARTENDSYMBOL.
startsym.size(optional)Holds the relative size of the line-start symbol. Value conforms to data.FONTSIZESCALE.
startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point. Value conforms to data.TSTAMPOFFSET.
startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
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.
width(optional)Width of the line. Value conforms to data.LINEWIDTH.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
x2(optional)Encodes the optional 2nd x coordinate. Value is a decimal number.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
y2(optional)Encodes the optional 2nd y coordinate. Value is a decimal number.
form(optional)Visual form of the line. Value conforms to data.LINEFORM.
width(optional)Width of the line. Value conforms to data.LINEWIDTH.
endsym(optional)Symbol rendered at end of line. Value conforms to data.LINESTARTENDSYMBOL.
endsym.size(optional)Holds the relative size of the line-end symbol. Value conforms to data.FONTSIZESCALE.
startsym(optional)Symbol rendered at start of line. Value conforms to data.LINESTARTENDSYMBOL.
startsym.size(optional)Holds the relative size of the line-start symbol. Value conforms to data.FONTSIZESCALE.
(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 capturing placement information with respect to the staff.
place(optional)Captures the placement of the item with respect to the staff with which it is associated. Value conforms to data.STAFFREL.
(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) Horizontal offset attributes specified in terms of time.
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
(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.
(MEI.shared) Visual offset attributes. Some items may have their location recorded in terms of pairs of offsets from their programmatically-determined location. The startho and endho attributes record the horizontal offsets of the start and end points of the item, respectively. Similarly, the startvo and endvo attributes record the vertical offsets of the start and end points of the item. The startto and endto attributes hold timestamp offsets, the most common use of which is as alternatives to the ho attributes.
(MEI.shared) Horizontal offset requiring a pair of attributes.
startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
(MEI.shared) Horizontal offset attributes requiring a pair of attributes specified in terms of time.
startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point. Value conforms to data.TSTAMPOFFSET.
endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point. Value conforms to data.TSTAMPOFFSET.
(MEI.shared) Vertical offset attributes requiring a pair of attributes.
startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
(MEI.shared) Output coordinate attributes. Some elements may have their exact rendered *output* coordinates recorded. x and y attributes indicate where to place the rendered output. Recording the coordinates of a feature in a facsimile requires the use of the facs attribute.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
(MEI.shared) Output coordinate attributes. Some elements may need 2 coordinate pairs to record their rendered *output* coordinates. The attributes indicate where to place the rendered output. Recording the coordinates of a feature in a facsimile requires the use of the facs attribute.
x2(optional)Encodes the optional 2nd x coordinate. Value is a decimal number.
y2(optional)Encodes the optional 2nd y coordinate. Value is a decimal number.
Component declarations that are shared between two or more modules.
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.
endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point. Value conforms to data.TSTAMPOFFSET.
endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
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.
place(optional)Captures the placement of the item with respect to the staff with which it is associated. Value conforms to data.STAFFREL.
startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point. Value conforms to data.TSTAMPOFFSET.
startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
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.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
x2(optional)Encodes the optional 2nd x coordinate. Value is a decimal number.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
y2(optional)Encodes the optional 2nd y coordinate. Value is a decimal number.
Visual component declarations.
endsym(optional)Symbol rendered at end of line. Value conforms to data.LINESTARTENDSYMBOL.
endsym.size(optional)Holds the relative size of the line-end symbol. Value conforms to data.FONTSIZESCALE.
form(optional)Visual form of the line. Value conforms to data.LINEFORM.
startsym(optional)Symbol rendered at start of line. Value conforms to data.LINESTARTENDSYMBOL.
startsym.size(optional)Holds the relative size of the line-start symbol. Value conforms to data.FONTSIZESCALE.
width(optional)Width of the line. Value conforms to data.LINEWIDTH.
Available at
lineA visual line that cannot be represented by a more specific; i.e., semantic, element.
User-defined symbols component declarations.
lineA visual line that cannot be represented by a more specific; i.e., semantic, element.
Declaration
<classSpec ident="att.line.vis" module="MEI.visual" type="atts">
<desc xml:lang="en">Attributes for describing the visual appearance of a line.</desc>
<classes>
<memberOf key="att.color"/>
<memberOf key="att.placementRelStaff"/>
<memberOf key="att.visualOffset"/>
<memberOf key="att.visualOffset2"/>
<memberOf key="att.xy"/>
<memberOf key="att.xy2"/>
</classes>
<attList>
<attDef ident="form" usage="opt">
<desc xml:lang="en">Visual form of the line.</desc>
<datatype>
<rng:ref name="data.LINEFORM"/>
</datatype>
</attDef>
<!-- @length not necessary: @length implies we know the direction of the vector which we can't know without establishing an end point, which in turn makes @length redundant. -->
<attDef ident="width" usage="opt">
<desc xml:lang="en">Width of the line.</desc>
<datatype>
<rng:ref name="data.LINEWIDTH"/>
</datatype>
</attDef>
<!-- additional visual characteristics of the line -->
<attDef ident="endsym" usage="opt">
<desc xml:lang="en">Symbol rendered at end of line.</desc>
<datatype>
<rng:ref name="data.LINESTARTENDSYMBOL"/>
</datatype>
</attDef>
<attDef ident="endsym.size" usage="opt">
<desc xml:lang="en">Holds the relative size of the line-end symbol.</desc>
<datatype>
<rng:ref name="data.FONTSIZESCALE"/>
</datatype>
</attDef>
<!-- Possible addition: <attDef ident="segments" usage="opt"> <desc xml:lang="en">Stores the number of segments used to render a dashed, dotted, or wavy line.</desc> <datatype> <rng:data type="positiveInteger"/> </datatype> </attDef> -->
<attDef ident="startsym" usage="opt">
<desc xml:lang="en">Symbol rendered at start of line.</desc>
<datatype>
<rng:ref name="data.LINESTARTENDSYMBOL"/>
</datatype>
</attDef>
<attDef ident="startsym.size" usage="opt">
<desc xml:lang="en">Holds the relative size of the line-start symbol.</desc>
<datatype>
<rng:ref name="data.FONTSIZESCALE"/>
</datatype>
</attDef>
<!-- Possible addition: <attDef ident="waveheight" usage="opt"> <desc xml:lang="en">Captures the wave height of a wavy line.</desc> <datatype> <rng:ref name="data.MEASUREMENT"/> </datatype> </attDef> -->
</attList>
</classSpec>