Represents one keyboard on a console.
Every organ must contain at least one keyboard.
|
Parent Elements (that contain this element)
|
Chamber |
|
Console |
Keyboard elements are normally contained within a Console element. |
Organ |
Keyboard elements may be contained within the Organ element
if the Console element has been omitted for simplicity. |
|
Child Elements (contained by this element)
|
compass
- The compass of the keyboard.
The value of this attribute must conform to the
standard for Compasses.
Integers alone may not be used to represent notes.
dateInstalled
- The date on which this Keyboard was installed
(see date formats).
This attribute should only be used for Keyboards added after the
original instrument was finished.
dateRemoved
- The date on which this Keyboard was removed
(see date formats).
divided
- The inclusion of this attribute means that the keyboard
is divided. The attribute's data contains the division point as
a pair of note names separated by a slash or hyphen; e.g. "b2/c3",
"f#2-g2". Each of the two note names must conform to the standard
for Note Names.
If the split point is not known, the value of this attribute
may be set to "yes".
enclosed
- This attribute may be used as a shortcut to indicate whether
the keyboard's stops are enclosed in a chamber with swell shades.
The value of this attribute must be "true" or "false".
This attribute should not be used if the Keyboard element is
contained, directly or indirectly, by a Chamber element.
id
- An identifier for referencing this element from within other elements.
installedBy
- The ID of the Builder element describing
the builder who installed the Keyboard.
This attribute should only be used for Keyboards added after the
original instrument was finished.
name
- The name of the keyboard, e.g. "Great", "Positif", "Brustwerk".
It should be rendered in the original language, and not Anglicized.
notes
- An integer representing the number of notes on the keyboard.
This attribute may be omitted if the number of notes can be
inferred from the compass.
position
- Indicates the physical position of the keyboard.
A manual keyboard is represented by one of the integer values
"1" through "7", where "1" indicates the lowest manual.
A pedal keyboard is represented by the value "P".
On those few instruments that have two pedalboards,
the second pedalboard is represented by the value "P2".
removedBy
- The ID of the Builder element describing
the builder who removed the Keyboard.
Here is a simple example of a keyboard:
<Keyboard name="Great" compass="CC-a''" notes="58" enclosed="no">
<Stop name="Open Diapason" pitch="8"> </Stop>
<Stop name="Octave" pitch="4"> </Stop>
</Keyboard>
Here is an example of a keyboard which is split at middle C.
(See Division for another way
of handling split keyboards.)
<Keyboard compass="CC-g''" notes="56" split="B/c">
<Stop name="Stopped Diapason" pitch="8" label="Stop'd Diap. Bass" compass="L"> </Stop>
<Stop name="Stopped Diapason" pitch="8" label="Stop'd Diap. Treble" compass="R"> </Stop>
<Stop name="Open Diapason" pitch="8" label="Open Diap. Bass" compass="L"> </Stop>
<Stop name="Open Diapason" pitch="8" label="Open Diap. Treble" compass="R"> </Stop>
<Stop name="Cornet" pitch="8" ranks="5" label="Cornet" compass="R"> </Stop>
</Keyboard>
<!ELEMENT Keyboard (
Accessory |
Chamber |
Coupler |
Division |
KeyAction |
Pressure |
Remark |
Stop |
StopAction |
Trap )* >
<!ATTLIST Keyboard
compass CDATA ""
dateInstalled CDATA ""
dateRemoved CDATA ""
divided CDATA ""
enclosed (true|false) #IMPLIED
id ID #IMPLIED
installedBy IDREF #IMPLIED
name CDATA ""
notes CDATA ""
order CDATA ""
removedBy IDREF #IMPLIED
>
Copyright © Institute for Pipe Organ Research And Education, Inc. 2002