This element represents one division of an organ,
but the meaning of "division" is a bit slippery,
and the "Division" element may be used in a number of different ways.
In simple specifications, it need not be used at all, and indeed,
should not be used unless necessary.
For more details on usage, see
Chambers, Divisions & Keyboards.
|
Parent Elements (that contain this element)
|
Chamber |
When one chamber contains the pipes for more than one division,
the corresponding Chamber element may contain Division elements. |
Console |
When contained within a Console element, a Division element
represents a "floating" division which is not permanently
connected to a keyboard. |
Keyboard |
When one keyboard controls more than one division,
the Division elements may be contained within a Keyboard element. |
Organ |
When contained within an Organ element, a Division element
represents a "floating" division which is not permanently
connected to a keyboard. This organization should only be used
when the Console element is omitted. |
|
Child Elements (contained by this element)
|
| Name | How Many | Description |
Accessory |
(zero or more) |
|
Chamber |
(zero or more) |
represents one chamber which contains some or all of the ranks
for this division. |
Coupler |
(zero or more) |
|
KeyAction |
(zero or more) |
|
Pressure |
(zero or more) |
the wind pressure for this Division, if different from the rest of the organ. |
Rank |
(zero or more) |
|
Remark |
(zero or more) |
remarks about this Division. |
Stop |
(zero or more) |
|
StopAction |
(zero or more) |
|
Trap |
(zero or more) |
|
compass
- The compass of the division.
The value of this attribute must conform to the
standard for Compasses.
Integers alone may not be used to represent notes.
The values "L" or "R" may be used to indicate that the
division contains the stops for the left or right sides
of a divided keyboard.
Note that the compass of a division may be different
from the compass of its corresponding keyboard;
for example, the division may have a compass of 73 notes,
while its keyboard may have a compass of 61 notes.
dateInstalled
- The date on which this Division was installed
(see date formats).
This attribute should only be used for Divisions added after the
original instrument was finished.
dateRemoved
- The date on which this Division was removed
(see date formats).
enclosed
- This attribute may be used as a shortcut to indicate whether
the division's stops and/or ranks 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 Division 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 Division.
This attribute should only be used for Divisions added after the
original instrument was finished.
keyboard
- The ID of the Keyboard element
describing the keyboard with which this division is associated.
This attribute may be omitted if the Division element is contained
within a Keyboard element.
If the division is not associated with one keyboard (as with
"floating" divisions), then this attribute should be omitted.
name
- The name of the division, e.g. "Great", "Positif", "Brustwerk".
It should be rendered in the original language, and not Anglicized.
notes
- An integer representing the number of notes in the division.
This attribute may be omitted if the number of notes can be
inferred from the compass.
order
- An integer which will be used to order the divisions for display purposes.
This order should correspond with the order in which the divisions appear on
the console. The numbers need not be contiguous.
removedBy
- The ID of the Builder element describing
the builder who removed the Division.
Here is an example of a floating division:
<Division name="Echo" compass="CC-c'''" notes="61" enclosed="yes">
<Stop name="Aeoline" pitch="8"> </Stop>
<Stop name="Unda Maris" pitch="8"> </Stop>
<Stop name="Vox Angelica" pitch="8" ranks="2"> </Stop>
</Division>
Here is an example of a split keyboard.
(See Keyboard for another way
of handling split keyboards.)
<Keyboard name="Manual" compass="CC-g''" notes="56">
<Division name="Left" compass="L">
<Stop name="Flautado" pitch="8"> </Stop>
<Stop name="Trompeta Real" pitch="8"> </Stop>
<Stop name="Bajoncillo" pitch="4"> </Stop>
</Division>
<Division name="Right" compass="R">
<Stop name="Flautado" pitch="8"> </Stop>
<Stop name="Trompeta Real" pitch="8"> </Stop>
<Stop name="Clarín" pitch="8"> </Stop>
</Division>
</Keyboard>
<!ELEMENT Division (
Accessory |
Chamber |
Coupler |
KeyAction |
Pressure |
Rank |
Remark |
Stop |
StopAction |
Trap )* >
<!ATTLIST Division
compass CDATA ""
dateInstalled CDATA ""
dateRemoved CDATA ""
enclosed (true|false) #IMPLIED
id ID #IMPLIED
installedBy IDREF #IMPLIED
keyboard IDREF #IMPLIED
name CDATA ""
notes CDATA ""
order CDATA ""
removedBy IDREF #IMPLIED
>
Copyright © Institute for Pipe Organ Research And Education, Inc. 2002