MusicXML 4.1 Draft
MusicXML 4.1 Draft > MusicXML Reference > Elements > The <frame> element

The <frame> element

Parent element: <harmony>

The frame type represents a frame or fretboard diagram used together with a chord symbol. The representation is based on the NIFF guitar grid with additional information.

Content

In this order

Attributes

Name Type Required?(Default) Description
color color No Indicates the color of an element.
Indicates the color of an element.
default-x tenths No Changes the computation of the default horizontal position. The origin is changed relative to the left-hand side of the note or the musical position within the bar. Positive x is right and negative x is left.

This attribute provides higher-resolution positioning data than the <offset> element. Applications reading a MusicXML file that can understand both features should generally rely on this attribute for its greater accuracy.
Changes the computation of the default horizontal position. The origin is changed relative to the left-hand side of the note or the musical position within the bar. Positive x is right and negative x is left.

This attribute provides higher-resolution positioning data than the <offset> element. Applications reading a MusicXML file that can understand both features should generally rely on this attribute for its greater accuracy.
default-y tenths No Changes the computation of the default vertical position. The origin is changed relative to the top line of the staff. Positive y is up and negative y is down.

This attribute provides higher-resolution positioning data than the placement attribute. Applications reading a MusicXML file that can understand both attributes should generally rely on this attribute for its greater accuracy.
Changes the computation of the default vertical position. The origin is changed relative to the top line of the staff. Positive y is up and negative y is down.

This attribute provides higher-resolution positioning data than the placement attribute. Applications reading a MusicXML file that can understand both attributes should generally rely on this attribute for its greater accuracy.
halign left-center-right No In cases where text extends over more than one line, horizontal alignment and justify values can be different. The most typical case is for credits, such as:

Words and music by Pat Songwriter

Typically this type of credit is aligned to the right, so that the position information refers to the right-most part of the text. But in this example, the text is center-justified, not right-justified.

The halign attribute is used in these situations. If it is not present, its value is the same as for the justify attribute. For elements where a justify attribute is not allowed, the default is implementation-dependent.
In cases where text extends over more than one line, horizontal alignment and justify values can be different. The most typical case is for credits, such as:

Words and music by Pat Songwriter

Typically this type of credit is aligned to the right, so that the position information refers to the right-most part of the text. But in this example, the text is center-justified, not right-justified.

The halign attribute is used in these situations. If it is not present, its value is the same as for the justify attribute. For elements where a justify attribute is not allowed, the default is implementation-dependent.
height tenths No Used to size and scale a frame. The frame should be scaled independently in X and Y if both height and width are specified. If only height is specified, the frame should be scaled proportionally to fit in the specified Y dimension.
Used to size and scale a frame. The frame should be scaled independently in X and Y if both height and width are specified. If only height is specified, the frame should be scaled proportionally to fit in the specified Y dimension.
id xs:ID No Specifies an ID that is unique to the entire document.
Specifies an ID that is unique to the entire document.
relative-x tenths No Changes the horizontal position relative to the default position, either as computed by the individual program, or as overridden by the default-x attribute. Positive x is right and negative x is left. It should be interpreted in the context of the <offset> element or directive attribute if those are present.
Changes the horizontal position relative to the default position, either as computed by the individual program, or as overridden by the default-x attribute. Positive x is right and negative x is left. It should be interpreted in the context of the <offset> element or directive attribute if those are present.
relative-y tenths No Changes the vertical position relative to the default position, either as computed by the individual program, or as overridden by the default-y attribute. Positive y is up and negative y is down. It should be interpreted in the context of the placement attribute if that is present.
Changes the vertical position relative to the default position, either as computed by the individual program, or as overridden by the default-y attribute. Positive y is up and negative y is down. It should be interpreted in the context of the placement attribute if that is present.
unplayed xs:token No Indicates what to display above a string that has no associated <frame-note> element. Typical values are x and the empty string. If the attribute is not present, the display of the unplayed string is application-defined.
Indicates what to display above a string that has no associated <frame-note> element. Typical values are x and the empty string. If the attribute is not present, the display of the unplayed string is application-defined.
valign valign-image No Indicates vertical alignment to the top, middle, or bottom of the image. The default is implementation-dependent.
Indicates vertical alignment to the top, middle, or bottom of the image. The default is implementation-dependent.
width tenths No Used to size and scale a frame. The frame should be scaled independently in X and Y if both height and width are specified. If only width is specified, the frame should be scaled proportionally to fit in the specified X dimension.
Used to size and scale a frame. The frame should be scaled independently in X and Y if both height and width are specified. If only width is specified, the frame should be scaled proportionally to fit in the specified X dimension.

Examples

This element is used in the following examples:

<barre><fingering> (Frame)<fret> (Frame)Tutorial: Chord Symbols