Music Encoding Initiative Guidelines

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.

Attributes

compact
full definition
by class
by module

@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.

@closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line.

@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.

@endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point.

@endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point.

@endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point.

@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.

@lform(optional)Describes the style 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.

@lwidth(optional)Width of a line.

@opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark.

@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.

@place(optional)Captures the placement of the item with respect to the staff with which it is associated.

@startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point.

@startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point.

@startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point.

@to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats.

@vgrp(optional)Provides a label for members of a vertically aligned group.

@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.

@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.

@x2(optional)Encodes the optional 2nd x coordinate.

@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.

@y2(optional)Encodes the optional 2nd y coordinate.

direct children

@opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark.

@closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line.

@angle.optimize(optional)Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing.

att.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.

att.lineRend.base(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.

att.placementRelStaff(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.

att.verticalGroup(MEI.shared) Attributes that record grouping of vertically aligned elements.

@vgrp(optional)Provides a label for members of a vertically aligned group.

att.visualOffset(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.

att.visualOffset.ho(MEI.shared) Horizontal offset attributes.

att.visualOffset.to(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.

att.visualOffset.vo(MEI.shared) Vertical offset attributes.

att.visualOffset2(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.

att.visualOffset2.ho(MEI.shared) Horizontal offset requiring a pair of attributes.

@startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point.

@endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point.

att.visualOffset2.to(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.

@endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point.

att.visualOffset2.vo(MEI.shared) Vertical offset attributes requiring a pair of attributes.

@startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point.

@endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point.

att.xy(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.

@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.

att.xy2(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.

@y2(optional)Encodes the optional 2nd y coordinate.

MEI.shared

@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.

@endho(optional)Records the horizontal adjustment of a feature’s programmatically-determined end point.

@endto(optional)Records a timestamp adjustment of a feature’s programmatically-determined end point.

@endvo(optional)Records a vertical adjustment of a feature’s programmatically-determined end point.

@lform(optional)Describes the style of a line.

@lwidth(optional)Width of a line.

@place(optional)Captures the placement of the item with respect to the staff with which it is associated.

@startho(optional)Records the horizontal adjustment of a feature’s programmatically-determined start point.

@startto(optional)Records a timestamp adjustment of a feature’s programmatically-determined start point.

@startvo(optional)Records a vertical adjustment of a feature’s programmatically-determined start point.

@to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats.

@vgrp(optional)Provides a label for members of a vertically aligned group.

@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.

@x2(optional)Encodes the optional 2nd x coordinate.

@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.

@y2(optional)Encodes the optional 2nd y coordinate.

MEI.visual

@angle.optimize(optional)Indicates that the slope of the hairpin can be adjusted to follow the content in order to optimize spacing.

@closed(optional)Applies to a "Rossini" hairpin, i.e., one where the normally open side is closed by a connecting line.

@opening(optional)Specifies the distance between the lines at the open end of a hairpin dynamic mark.

Declaration


                                 <classSpec xmlns="http://www.tei-c.org/ns/1.0" rend="add" 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>
                                             
                                             <dataRef key="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>
                                             
                                             <dataRef key="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>
                                             
                                             <dataRef key="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>
                                             
                                             <dataRef key="data.BOOLEAN"/>
                                             </datatype>
                                          </attDef>
                                       </attList>
                                    </classSpec>

MEI Version: 6.0-dev+anyStart(#021ede6)