<symbol>

A reference to a previously defined symbol.
Module
MEI.shared
Attributes
@color, @glyph.auth, @glyph.name, @glyph.num, @glyph.uri, @ho, @label, @scale, @type, @vo, @xml:id
@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.
<symbol>att.symbol.visatt.color@color
@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.)
<symbol>att.symbol.visatt.extSymatt.extSym.auth@glyph.auth
@glyph.name(optional)Glyph name. Value is plain text.
<symbol>att.symbol.visatt.extSymatt.extSym.names@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. Value conforms to data.HEXNUM.
<symbol>att.symbol.visatt.extSymatt.extSym.names@glyph.num
@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.
<symbol>att.symbol.visatt.extSymatt.extSym.auth@glyph.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.
<symbol>att.symbol.visatt.visualOffsetatt.visualOffset.ho@ho
@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.
<symbol>att.commonatt.labelled@label
@scale(optional)Scale factor to be applied to the feature to make it the desired display size. Value conforms to data.PERCENT.
<symbol>att.symbol.visatt.scalable@scale
@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.
<symbol>att.commonatt.typed@type
@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.
<symbol>att.symbol.visatt.visualOffsetatt.visualOffset.vo@vo
@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.
<symbol>att.commonatt.id@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.visual) Visual domain attributes.
(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.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 describe relative size.
@scale(optional)Scale factor to be applied to the feature to make it the desired display size. Value conforms to 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.
@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.
@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.
@scale(optional)Scale factor to be applied to the feature to make it the desired display size. Value conforms to data.PERCENT.
@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.
Member of
model.textPhraseLike.limitedGroups textual elements that occur at the level of individual words or phrases. This class is equivalent to the model.textPhraseLike class without the pb element.
Contained By
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases. This class is equivalent to the model.textPhraseLike class without the pb element.
<dir>An instruction expressed as a combination of text and symbols, typically above, below, or between staves, but not on the staff — that is not encoded elsewhere in more specific elements, like <tempo>, <dynam> or <repeatMark>.
<dynam>Indication of the volume of a note, phrase, or section of music.
<f>Single element of a figured bass indication.
<fing>An individual finger in a fingering indication.
<gliss>A continuous or sliding movement from one pitch to another, usually indicated by a straight or wavy line.
<harm>An indication of harmony, e.g., chord names, tablature grids, harmonic analysis, figured bass.
<label>A container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the @label attribute.
<labelAbbr>A label on the pages following the first.
<octave>An indication that a passage should be performed one or more octaves above or below its written pitch.
<ornam>An element indicating an ornament that is not a mordent, turn, or trill.
<pgFoot>A running footer.
<pgHead>A running header.
<pubPlace>Name of the place where a bibliographic item was published.
<repeatMark> An instruction expressed as a combination of text and symbols – segno and coda – typically above, below, or between staves, but not on the staff.
<syl>Individual lyric syllable.
<tempo>Text and symbols descriptive of tempo, mood, or style, e.g., "allarg.", "a tempo", "cantabile", "Moderato", "♩=60", "Moderato ♩ =60").
(MEI.shared) Groups textual elements that occur at the level of individual words or phrases.
<date>A string identifying a point in time or the time period between two such points.
<name>Proper noun or noun phrase.
<persName>Designation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
<rend>A formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
(MEI.shared) Groups elements that may appear as part of a bibliographic title.
<title>Title of a bibliographic entity.
<gliss>A continuous or sliding movement from one pitch to another, usually indicated by a straight or wavy line.
<octave>An indication that a passage should be performed one or more octaves above or below its written pitch.
<repeatMark> An instruction expressed as a combination of text and symbols – segno and coda – typically above, below, or between staves, but not on the staff.
<fing>An individual finger in a fingering indication.
<f>Single element of a figured bass indication.
<harm>An indication of harmony, e.g., chord names, tablature grids, harmonic analysis, figured bass.
<persName>Designation for an individual, including any or all of that individual's forenames, surnames, honorific titles, and added names.
<date>A string identifying a point in time or the time period between two such points.
<dir>An instruction expressed as a combination of text and symbols, typically above, below, or between staves, but not on the staff — that is not encoded elsewhere in more specific elements, like <tempo>, <dynam> or <repeatMark>.
<dynam>Indication of the volume of a note, phrase, or section of music.
<label>A container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the @label attribute.
<labelAbbr>A label on the pages following the first.
<name>Proper noun or noun phrase.
<ornam>An element indicating an ornament that is not a mordent, turn, or trill.
<pgFoot>A running footer.
<pgHead>A running header.
<pubPlace>Name of the place where a bibliographic item was published.
<rend>A formatting element indicating special visual rendering, e.g., bold or italicized, of a text word or phrase.
<syl>Individual lyric syllable.
<tempo>Text and symbols descriptive of tempo, mood, or style, e.g., "allarg.", "a tempo", "cantabile", "Moderato", "♩=60", "Moderato ♩ =60").
<title>Title of a bibliographic entity.
May Contain
– (<symbol> may not have child elements)
Remarks

The starting point, e.g., "hotspot", of the symbol may be identified in absolute output coordinate terms using the @x and @y attributes or relative to another element using the @startid attribute. Attributes in the att.visualOffset class may be used to record horizontal, vertical, or time offsets from the absolute coordinates or from the location of the referenced element. The @altsym attribute must contain the id of a symbolDef [not available in this MEI customization] element. The @scale attribute indicates that the printed output must be scaled by the specified percentage.

Constraints

In the symbolDef context, symbol must have either a startid attribute or x and y attributes.
In the symbolDef context, symbol must have one of the following attributes: altsym, glyph.name, or glyph.num.

Declaration
<elementSpec rend="add" ident="symbol" module="MEI.shared">
<desc xml:lang="en">A reference to a previously defined symbol.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.symbol.vis"/>
<memberOf key="model.textPhraseLike.limited"/>
</classes>
<content>
<empty/>
</content>
<constraintSpec ident="symbolDef_symbol_attributes_required" scheme="schematron">
<constraint>
<sch:rule context="mei:symbol[ancestor::mei:symbolDef]">
<sch:assert test="@startid or (@x and @y)">In the symbolDef context, symbol must have either a startid attribute or x and y attributes.</sch:assert>
<sch:assert test="@altsym or @glyph.name or @glyph.num">In the symbolDef context, symbol must have one of the following attributes: altsym, glyph.name, or glyph.num.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<remarks xml:lang="en">
<p>The starting point,
<abbr>e.g.</abbr>
, "hotspot", of the symbol may be identified in absolute output coordinate terms using the <att>x</att> and <att>y</att> attributes or relative to another element using the <att>startid</att> attribute. Attributes in the att.visualOffset class may be used to record horizontal, vertical, or time offsets from the absolute coordinates or from the location of the referenced element. The <att>altsym</att> attribute must contain the id of a <gi scheme="MEI">symbolDef</gi> element. The <att>scale</att> attribute indicates that the printed output must be scaled by the specified percentage.</p>
</remarks>
</elementSpec>
MEI Version: 6.0-dev+basic(#cd58552)