You are here: MusicXML Reference > Score Schema (XSD) > Complex Types > Complex Type: frame

Complex Type: frame

Description

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

Restricting xs:anyType

Attributes
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 
  1..1 
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
Definition
<xs:complexType name="frame">
  <xs:annotation>
    <xs:documentation>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.</xs:documentation>
  </xs:annotation>
  <xs:sequence>
    <xs:element name="frame-strings" type="xs:positiveInteger">
      <xs:annotation>
        <xs:documentation>The frame-strings element gives the overall size of the frame in vertical lines (strings).</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="frame-frets" type="xs:positiveInteger">
      <xs:annotation>
        <xs:documentation>The frame-frets element gives the overall size of the frame in horizontal spaces (frets).</xs:documentation>
      </xs:annotation>
    </xs:element>
    <xs:element name="first-fret" type="first-fret" minOccurs="0">
      <xsd:annotation>
        <xsd:documentation>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. The optional text attribute indicates how this is represented in the fret diagram, while the location attribute indicates whether the text appears to the left or right of the frame.</xsd:documentation>
      </xsd:annotation>
    </xs:element>
    <xs:element name="frame-note" type="frame-note" maxOccurs="unbounded">
      <xsd:annotation>
        <xsd:documentation>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.</xsd:documentation>
      </xsd:annotation>
    </xs:element>
  </xs:sequence>
  <xs:attributeGroup ref="position" />
  <xs:attributeGroup ref="color" />
  <xs:attributeGroup ref="halign" />
  <xs:attributeGroup ref="valign-image" />
  <xs:attribute name="height" type="tenths">
    <xsd:annotation>
      <xsd:documentation>
      </xsd:documentation>
    </xsd:annotation>
  </xs:attribute>
  <xs:attribute name="width" type="tenths">
    <xsd:annotation>
      <xsd:documentation>
      </xsd:documentation>
    </xsd:annotation>
  </xs:attribute>
  <xs:attribute name="unplayed" type="xs:token">
    <xsd:annotation>
      <xsd:documentation>
      </xsd:documentation>
    </xsd:annotation>
  </xs:attribute>
</xs:complexType>

 

MusicXML Documentation Home
Last built 2/20/2015

7007 Winchester Circle, Suite 140

Boulder, CO 80301