Element: 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
Type frame
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
- Complex Type harmony
Example
<harmony default-y="110" font-family="Arial">
<root>
<root-step>A</root-step>
</root>
<kind halign="center" text="">major</kind>
<frame default-y="93" halign="center" unplayed="x" valign="top">
<frame-strings>6</frame-strings>
<frame-frets>4</frame-frets>
<frame-note>
<string>5</string>
<fret>0</fret>
</frame-note>
<frame-note>
<string>4</string>
<fret>2</fret>
<fingering>2</fingering>
</frame-note>
<frame-note>
<string>3</string>
<fret>2</fret>
<fingering>3</fingering>
</frame-note>
<frame-note>
<string>2</string>
<fret>2</fret>
<fingering>4</fingering>
</frame-note>
<frame-note>
<string>1</string>
<fret>0</fret>
</frame-note>
</frame>
</harmony>
