Description
Textual direction types may have more than 1 component due to multiple fonts. The dynamics element may also be used in the notations element. Attribute groups related to print suggestions apply to the individual direction-type, not to the overall direction.
Derived By
Restricting xs:anyType
Content Model
Contains elements as defined in the following table.
Component |
Type |
Occurs |
Default |
Description |
|
|
1..1 |
|
|
accordion-registration |
accordion-registration |
1..1 |
|
The accordion-registration type is use for accordion registration symbols. These are circular symbols divided horizontally into high, middle, and low sections that correspond to 4', 8', and 16' pipes. Each accordion-high, accordion-middle, and accordion-low element represents the presence of one or more dots in the registration diagram. An accordion-registration element needs to have at least one of the child elements present.
|
bracket |
bracket |
1..1 |
|
Brackets are combined with words in a variety of modern directions. The line-type is solid by default.
|
coda |
empty-print-style-align |
1..* |
|
The coda element is the visual indicator of a coda sign. A sound element is needed to guide playback applications reliably.
|
damp |
empty-print-style-align |
1..1 |
|
The damp element specifies a harp damping mark.
|
damp-all |
empty-print-style-align |
1..1 |
|
The damp-all element specifies a harp damping mark for all strings.
|
dashes |
dashes |
1..1 |
|
The dashes type represents dashes, used for instance with cresc. and dim. marks.
|
dynamics |
dynamics |
1..* |
|
Dynamics can be associated either with a note or a general musical direction. To avoid inconsistencies between and amongst the letter abbreviations for dynamics (what is sf vs. sfz, standing alone or with a trailing dynamic that is not always piano), we use the actual letters as the names of these dynamic elements. The other-dynamics element allows other dynamic marks that are not covered here, but many of those should perhaps be included in a more general musical direction element. Dynamics elements may also be combined to create marks not covered by a single element, such as sfmp. These letter dynamic symbols are separated from crescendo, decrescendo, and wedge indications. Dynamic representation is inconsistent in scores. Many things are assumed by the composer and left out, such as returns to original dynamics. Systematic representations are quite complex: for example, Humdrum has at least 3 representation formats related to dynamics. The MusicXML format captures what is in the score, but does not try to be optimal for analysis or synthesis of dynamics.
|
eyeglasses |
empty-print-style-align |
1..1 |
|
The eyeglasses element specifies the eyeglasses symbol, common in commercial music.
|
harp-pedals |
harp-pedals |
1..1 |
|
The harp-pedals type is used to create harp pedal diagrams. The pedal-step and pedal-alter elements use the same values as the step and alter elements. For easiest reading, the pedal-tuning elements should follow standard harp pedal order, with pedal-step values of D, C, B, E, F, G, and A.
|
image |
image |
1..1 |
|
The image type is used to include graphical images in a score.
|
metronome |
metronome |
1..1 |
|
The metronome type represents metronome marks and other metric relationships. The beat-unit group and per-minute element specify regular metronome marks. The metronome-note and metronome-relation elements allow for the specification of more complicated metric relationships, such as swing tempo marks where two eighths are equated to a quarter note / eighth note triplet.
|
octave-shift |
octave-shift |
1..1 |
|
The octave shift type indicates where notes are shifted up or down from their true pitched values because of printing difficulty. Thus a treble clef line noted with 8va will be indicated with an octave-shift down from the pitch data indicated in the notes.
|
other-direction |
other-direction |
1..1 |
|
The other-direction type is used to define any direction symbols not yet in the current version of the MusicXML format. This allows extended representation, though without application interoperability.
|
pedal |
pedal |
1..1 |
|
The pedal type represents piano pedal marks. The change and continue types are used when the line attribute is yes. The change type indicates a pedal lift and retake indicated with an inverted V marking. The continue type allows more precise formatting across system breaks and for more complex pedaling lines. The alignment attributes are ignored if the line attribute is yes.
|
percussion |
percussion |
1..* |
|
The percussion element is used to define percussion pictogram symbols. Definitions for these symbols can be found in Kurt Stone's "Music Notation in the Twentieth Century" on pages 206-212 and 223. Some values are added to these based on how usage has evolved in the 30 years since Stone's book was published.
|
principal-voice |
principal-voice |
1..1 |
|
The principal-voice element represents principal and secondary voices in a score, either for analysis or for square bracket symbols that appear in a score. The content of the principal-voice element is used for analysis and may be any text value. When used for analysis separate from any printed score markings, the symbol attribute should be set to "none".
|
rehearsal |
formatted-text |
1..* |
|
The rehearsal type specifies a rehearsal mark. Language is Italian ("it") by default. Enclosure is square by default. Left justification is assumed if not specified.
|
scordatura |
scordatura |
1..1 |
|
Scordatura string tunings are represented by a series of accord elements, similar to the staff-tuning elements. Strings are numbered from high to low.
|
segno |
empty-print-style-align |
1..* |
|
The segno element is the visual indicator of a segno sign. A sound element is needed to guide playback applications reliably.
|
string-mute |
string-mute |
1..1 |
|
The string-mute type represents string mute on and mute off symbols.
|
wedge |
wedge |
1..1 |
|
The wedge type represents crescendo and diminuendo wedge symbols. The type attribute is crescendo for the start of a wedge that is closed at the left side, and diminuendo for the start of a wedge that is closed on the right side. Spread values are measured in tenths; those at the start of a crescendo wedge or end of a diminuendo wedge are ignored. The niente attribute is yes if a circle appears at the point of the wedge, indicating a crescendo from nothing or diminuendo to nothing. It is no by default, and used only when the type is crescendo, or the type is stop for a wedge that began with a diminuendo type. The line-type is solid by default.
|
words |
formatted-text |
1..* |
|
The words element specifies a standard text direction. Left justification is assumed if not specified. Language is Italian ("it") by default. Enclosure is none by default.
|
|
|
|
|
|
Referenced By
Definition
<xs:complexType name="direction-type">
<xs:annotation>
<xs:documentation>Textual direction types may have more than 1 component due to multiple fonts. The dynamics element may also be used in the notations element. Attribute groups related to print suggestions apply to the individual direction-type, not to the overall direction.</xs:documentation>
</xs:annotation>
<xs:choice>
<xs:element name="rehearsal" type="formatted-text" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The rehearsal type specifies a rehearsal mark. Language is Italian ("it") by default. Enclosure is square by default. Left justification is assumed if not specified.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="segno" type="empty-print-style-align" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The segno element is the visual indicator of a segno sign. A sound element is needed to guide playback applications reliably.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="words" type="formatted-text" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The words element specifies a standard text direction. Left justification is assumed if not specified. Language is Italian ("it") by default. Enclosure is none by default.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="coda" type="empty-print-style-align" maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>The coda element is the visual indicator of a coda sign. A sound element is needed to guide playback applications reliably.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="wedge" type="wedge">
<xsd:annotation>
<xsd:documentation>The wedge type represents crescendo and diminuendo wedge symbols. The type attribute is crescendo for the start of a wedge that is closed at the left side, and diminuendo for the start of a wedge that is closed on the right side. Spread values are measured in tenths; those at the start of a crescendo wedge or end of a diminuendo wedge are ignored. The niente attribute is yes if a circle appears at the point of the wedge, indicating a crescendo from nothing or diminuendo to nothing. It is no by default, and used only when the type is crescendo, or the type is stop for a wedge that began with a diminuendo type. The line-type is solid by default.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="dynamics" type="dynamics" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>Dynamics can be associated either with a note or a general musical direction. To avoid inconsistencies between and amongst the letter abbreviations for dynamics (what is sf vs. sfz, standing alone or with a trailing dynamic that is not always piano), we use the actual letters as the names of these dynamic elements. The other-dynamics element allows other dynamic marks that are not covered here, but many of those should perhaps be included in a more general musical direction element. Dynamics elements may also be combined to create marks not covered by a single element, such as sfmp.
These letter dynamic symbols are separated from crescendo, decrescendo, and wedge indications. Dynamic representation is inconsistent in scores. Many things are assumed by the composer and left out, such as returns to original dynamics. Systematic representations are quite complex: for example, Humdrum has at least 3 representation formats related to dynamics. The MusicXML format captures what is in the score, but does not try to be optimal for analysis or synthesis of dynamics.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="dashes" type="dashes">
<xsd:annotation>
<xsd:documentation>The dashes type represents dashes, used for instance with cresc. and dim. marks.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="bracket" type="bracket">
<xsd:annotation>
<xsd:documentation>Brackets are combined with words in a variety of modern directions. The line-end attribute specifies if there is a jog up or down (or both), an arrow, or nothing at the start or end of the bracket. If the line-end is up or down, the length of the jog can be specified using the end-length attribute. The line-type is solid by default.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="pedal" type="pedal">
<xsd:annotation>
<xsd:documentation>The pedal type represents piano pedal marks. The line attribute is yes if pedal lines are used. The sign attribute is yes if Ped and * signs are used. For MusicXML 2.0 compatibility, the sign attribute is yes by default if the line attribute is no, and is no by default if the line attribute is yes. The change and continue types are used when the line attribute is yes. The change type indicates a pedal lift and retake indicated with an inverted V marking. The continue type allows more precise formatting across system breaks and for more complex pedaling lines. The alignment attributes are ignored if the line attribute is yes.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="metronome" type="metronome">
<xsd:annotation>
<xsd:documentation>The metronome type represents metronome marks and other metric relationships. The beat-unit group and per-minute element specify regular metronome marks. The metronome-note and metronome-relation elements allow for the specification of more complicated metric relationships, such as swing tempo marks where two eighths are equated to a quarter note / eighth note triplet. The parentheses attribute indicates whether or not to put the metronome mark in parentheses; its value is no if not specified.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="octave-shift" type="octave-shift">
<xsd:annotation>
<xsd:documentation>The octave shift type indicates where notes are shifted up or down from their true pitched values because of printing difficulty. Thus a treble clef line noted with 8va will be indicated with an octave-shift down from the pitch data indicated in the notes. A size of 8 indicates one octave; a size of 15 indicates two octaves.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="harp-pedals" type="harp-pedals">
<xsd:annotation>
<xsd:documentation>The harp-pedals type is used to create harp pedal diagrams. The pedal-step and pedal-alter elements use the same values as the step and alter elements. For easiest reading, the pedal-tuning elements should follow standard harp pedal order, with pedal-step values of D, C, B, E, F, G, and A.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="damp" type="empty-print-style-align">
<xs:annotation>
<xs:documentation>The damp element specifies a harp damping mark.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="damp-all" type="empty-print-style-align">
<xs:annotation>
<xs:documentation>The damp-all element specifies a harp damping mark for all strings.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="eyeglasses" type="empty-print-style-align">
<xs:annotation>
<xs:documentation>The eyeglasses element specifies the eyeglasses symbol, common in commercial music.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="string-mute" type="string-mute">
<xsd:annotation>
<xsd:documentation>The string-mute type represents string mute on and mute off symbols.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="scordatura" type="scordatura">
<xsd:annotation>
<xsd:documentation>Scordatura string tunings are represented by a series of accord elements, similar to the staff-tuning elements. Strings are numbered from high to low.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="image" type="image">
<xsd:annotation>
<xsd:documentation>The image type is used to include graphical images in a score.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="principal-voice" type="principal-voice">
<xsd:annotation>
<xsd:documentation>The principal-voice element represents principal and secondary voices in a score, either for analysis or for square bracket symbols that appear in a score. The symbol attribute indicates the type of symbol used at the start of the principal-voice. The content of the principal-voice element is used for analysis and may be any text value. When used for analysis separate from any printed score markings, the symbol attribute should be set to "none".</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="accordion-registration" type="accordion-registration">
<xsd:annotation>
<xsd:documentation>The accordion-registration type is use for accordion registration symbols. These are circular symbols divided horizontally into high, middle, and low sections that correspond to 4', 8', and 16' pipes. Each accordion-high, accordion-middle, and accordion-low element represents the presence of one or more dots in the registration diagram. An accordion-registration element needs to have at least one of the child elements present.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="percussion" type="percussion" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>The percussion element is used to define percussion pictogram symbols. Definitions for these symbols can be found in Kurt Stone's "Music Notation in the Twentieth Century" on pages 206-212 and 223. Some values are added to these based on how usage has evolved in the 30 years since Stone's book was published.</xsd:documentation>
</xsd:annotation>
</xs:element>
<xs:element name="other-direction" type="other-direction">
<xsd:annotation>
<xsd:documentation>The other-direction type is used to define any direction symbols not yet in the current version of the MusicXML format. This allows extended representation, though without application interoperability.</xsd:documentation>
</xsd:annotation>
</xs:element>
</xs:choice>
</xs:complexType>