frame.md 3.6 KB


source: https://www.w3.org/2021/06/musicxml40/musicxml-reference/elements/frame/

downloaded: 2026-01-30T08:41:22.547Z

The

MusicXML 4.0 >

MusicXML reference >
Elements >
frame

The

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. The frame type's unplayed attribute 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.

Content

In this order

  • (Required)
  • (Required)
  • (Optional)
  • (One or more times)
  • Attributes

    Examples

    This element is used in the following examples:

    , (Frame), (Frame), Tutorial: Chord Symbols

    Name Type Required? Description
    color color No 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 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.
    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 SongwriterTypically 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
    id ID No 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 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.
    unplayed token No
    valign valign-image No Indicates vertical alignment to the top, middle, or bottom of the image. The default is implementation-dependent.
    width tenths No