att.hairpin.vis

Visual domain attributes. The startho and startvo attributes record the horizontal and vertical offsets of the left end, endho and endvo record the horizontal and vertical offsets of the right end, and the opening attribute records the width of the opening in staff inter-line units. The x and y attributes give the absolute coordinates of the left end point, and x2 and y2 the right end point, of an imaginary line that defines the length of the hairpin and horizontally bifurcates it. The so-called "pitch" of hairpin may be controlled by use of the startho, endho, startvo, and endvo attributes, while the placement of the entire rendered mark may be controlled by use of the ho and vo attributes.
Module
MEI.visual
Attributes
angle.optimize, closed, color, endho, endto, endvo, ho, lform, lsegs, lwidth, opening, opening.vertical, place, startho, startto, startvo, to, vgrp, vo, x, x2, y, y2
angle.optimize(optional)Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing. Value conforms to data.BOOLEAN.
<att.hairpin.vis>direct children@angle.optimize
closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line. Value conforms to data.BOOLEAN.
<att.hairpin.vis>direct children@closed
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.
<att.hairpin.vis>att.color@color
endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.ho@endho
endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point. Value conforms to data.TSTAMPOFFSET.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.to@endto
endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point. Value conforms to data.MEASUREMENTSIGNED.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.vo@endvo
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.
<att.hairpin.vis>att.visualOffsetatt.visualOffset.ho@ho
lform(optional)Describes the style of a line. Value conforms to data.LINEFORM.
<att.hairpin.vis>att.lineRend.base@lform
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.
<att.hairpin.vis>att.lineRend.base@lsegs
lwidth(optional)Width of a line. Value conforms to data.LINEWIDTH.
<att.hairpin.vis>att.lineRend.base@lwidth
opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark. Value conforms to data.MEASUREMENTUNSIGNED.
<att.hairpin.vis>direct children@opening
opening.vertical(optional)Indicates that the opening points are aligned with an imaginary line that is always 90° perpendicular to the horizontal plane, regardless of any angle or start/end adjustments, including when the hairpin is angled with @angle.optimize or through @endvo/@startvo adjustments. Value conforms to data.BOOLEAN.
<att.hairpin.vis>direct children@opening.vertical
place(optional)Captures the placement of the item with respect to the staff with which it is associated. Value conforms to data.STAFFREL.
<att.hairpin.vis>att.placementRelStaff@place
startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.ho@startho
startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point. Value conforms to data.TSTAMPOFFSET.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.to@startto
startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point. Value conforms to data.MEASUREMENTSIGNED.
<att.hairpin.vis>att.visualOffset2att.visualOffset2.vo@startvo
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.
<att.hairpin.vis>att.visualOffsetatt.visualOffset.to@to
vgrp(optional)Provides a label for members of a vertically aligned group. Value is a positive integer.
<att.hairpin.vis>att.verticalGroup@vgrp
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.
<att.hairpin.vis>att.visualOffsetatt.visualOffset.vo@vo
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.
<att.hairpin.vis>att.xy@x
x2(optional)Encodes the optional 2nd x coordinate. Value is a decimal number.
<att.hairpin.vis>att.xy2@x2
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.
<att.hairpin.vis>att.xy@y
y2(optional)Encodes the optional 2nd y coordinate. Value is a decimal number.
<att.hairpin.vis>att.xy2@y2
opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark. Value conforms to data.MEASUREMENTUNSIGNED.
closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line. Value conforms to data.BOOLEAN.
opening.vertical(optional)Indicates that the opening points are aligned with an imaginary line that is always 90° perpendicular to the horizontal plane, regardless of any angle or start/end adjustments, including when the hairpin is angled with @angle.optimize or through @endvo/@startvo adjustments. Value conforms to data.BOOLEAN.
angle.optimize(optional)Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing. Value conforms to data.BOOLEAN.
(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 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) 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) Attributes that record grouping of vertically aligned elements.
vgrp(optional)Provides a label for members of a vertically aligned group. Value is a positive integer.
(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.
lform(optional)Describes the style of a line. Value conforms to data.LINEFORM.
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.
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.
vgrp(optional)Provides a label for members of a vertically aligned group. Value is a positive integer.
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.
angle.optimize(optional)Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing. Value conforms to data.BOOLEAN.
closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line. Value conforms to data.BOOLEAN.
opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark. Value conforms to data.MEASUREMENTUNSIGNED.
opening.vertical(optional)Indicates that the opening points are aligned with an imaginary line that is always 90° perpendicular to the horizontal plane, regardless of any angle or start/end adjustments, including when the hairpin is angled with @angle.optimize or through @endvo/@startvo adjustments. Value conforms to data.BOOLEAN.
Available at
hairpinIndicates continuous dynamics expressed on the score as wedge-shaped graphics, e.g., < and >.
Common Music Notation (CMN) repertoire component declarations.
hairpinIndicates continuous dynamics expressed on the score as wedge-shaped graphics, e.g., < and >.
Declaration
<classSpec ident="att.hairpin.vis" module="MEI.visual" type="atts">
<desc xml:lang="en">Visual domain attributes. The startho and startvo attributes record the horizontal and vertical offsets of the left end, endho and endvo record the horizontal and vertical offsets of the right end, and the opening attribute records the width of the opening in staff inter-line units. The x and y attributes give the absolute coordinates of the left end point, and x2 and y2 the right end point, of an imaginary line that defines the length of the hairpin and horizontally bifurcates it. The so-called "pitch" of hairpin may be controlled by use of the startho, endho, startvo, and endvo attributes, while the placement of the entire rendered mark may be controlled by use of the ho and vo attributes.</desc>
<classes>
<memberOf key="att.color"/>
<memberOf key="att.lineRend.base"/>
<memberOf key="att.placementRelStaff"/>
<memberOf key="att.verticalGroup"/>
<memberOf key="att.visualOffset"/>
<memberOf key="att.visualOffset2"/>
<memberOf key="att.xy"/>
<memberOf key="att.xy2"/>
</classes>
<attList>
<attDef ident="opening" usage="opt">
<desc xml:lang="en">Specifies the distance between the lines at the open end of a hairpin dynamic mark.</desc>
<datatype>
<rng:ref name="data.MEASUREMENTUNSIGNED"/>
</datatype>
</attDef>
<attDef ident="closed" usage="opt">
<desc xml:lang="en">Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line.</desc>
<datatype>
<rng:ref name="data.BOOLEAN"/>
</datatype>
</attDef>
<attDef ident="opening.vertical" usage="opt">
<desc xml:lang="en">Indicates that the opening points are aligned with an imaginary line that is always 90° perpendicular to the horizontal plane, regardless of any angle or start/end adjustments, including when the hairpin is angled with @angle.optimize or through @endvo/@startvo adjustments.</desc>
<datatype>
<rng:ref name="data.BOOLEAN"/>
</datatype>
</attDef>
<attDef ident="angle.optimize" usage="opt">
<desc xml:lang="en">Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing.</desc>
<datatype>
<rng:ref name="data.BOOLEAN"/>
</datatype>
</attDef>
</attList>
</classSpec>
MEI Version: 5.0(#eb14650)