You are here: MusicXML Reference > Score Schema (XSD) > Elements > Element: frame

Element: frame


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.

Derived By

Type frame

Name  Type  Required?  Default  Description 
default-x  tenths  No 
default-y  tenths  No 
relative-x  tenths  No 
relative-y  tenths  No 
color  color  No 
halign  left-center-right  No 
valign  valign-image  No  The valign attribute is used to indicate vertical alignment to the top, middle, bottom, or baseline of the text or image. Defaults are implementation-dependent.
height  tenths  No 
width  tenths  No 
unplayed  xs:token  No  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 Model

Contains elements as defined in the following table.

Component  Type  Occurs  Default  Description 
frame-strings  xs:positiveInteger  1..1 

The frame-strings element gives the overall size of the frame in vertical lines (strings).

frame-frets  xs:positiveInteger  1..1 

The frame-frets element gives the overall size of the frame in horizontal spaces (frets).

first-fret  first-fret  0..1 

The first-fret type indicates which fret is shown in the top space of the frame; it is fret 1 if the element is not present.

frame-note  frame-note  1..* 

The frame-note type represents each note included in the frame. An open string will have a fret value of 0, while a muted string will not be associated with a frame-note element.

Referenced By

      <harmony default-y="110" font-family="Arial">
        <kind halign="center" text="">major</kind>
          <frame default-y="93" halign="center" unplayed="x" valign="top">



See harmony


MusicXML Documentation Home
Last built 2/20/2015

7007 Winchester Circle, Suite 140

Boulder, CO 80301