Overview The "Keyboard" Element Table of
Contents

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)

NameHow ManyDescription
Accessory (zero or more)  
Chamber (zero or more)  
Coupler (zero or more)  
Division (zero or more)  
KeyAction (zero or more)  
Pressure (zero or more)  
Remark (zero or more)   remarks about this Keyboard.
Stop (zero or more)  
StopAction (zero or more)  
Trap (zero or more)  

  Attributes
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.
  Examples

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>
  DTD Fragment
<!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