Description
The midi-instrument type defines MIDI 1.0 instrument playback. The midi-instrument element can be a part of either the score-instrument element at the start of a part, or the sound element within a part. The id attribute refers to the score-instrument affected by the change.
Derived By
Type midi-instrument
Attributes
Name |
Type |
Required? |
Default |
Description |
id |
xs:IDREF |
Yes |
|
|
Content Model
Contains elements as defined in the following table.
Component |
Type |
Occurs |
Default |
Description |
|
|
1..1 |
|
|
midi-channel |
midi-16 |
0..1 |
|
The midi-channel element specifies a MIDI 1.0 channel number ranging from 1 to 16.
|
midi-name |
xs:string |
0..1 |
|
The midi-name element corresponds to a ProgramName meta-event within a Standard MIDI File.
|
midi-bank |
midi-16384 |
0..1 |
|
The midi-bank element specified a MIDI 1.0 bank number ranging from 1 to 16,384.
|
midi-program |
midi-128 |
0..1 |
|
The midi-program element specifies a MIDI 1.0 program number ranging from 1 to 128.
|
midi-unpitched |
midi-128 |
0..1 |
|
For unpitched instruments, the midi-unpitched element specifies a MIDI 1.0 note number ranging from 1 to 128. It is usually used with MIDI banks for percussion. Note that MIDI 1.0 note numbers are generally specified from 0 to 127 rather than the 1 to 128 numbering used in this element.
|
volume |
percent |
0..1 |
|
The volume element value is a percentage of the maximum ranging from 0 to 100, with decimal values allowed. This corresponds to a scaling value for the MIDI 1.0 channel volume controller.
|
pan |
rotation-degrees |
0..1 |
|
The pan and elevation elements allow placing of sound in a 3-D space relative to the listener. Both are expressed in degrees ranging from -180 to 180. For pan, 0 is straight ahead, -90 is hard left, 90 is hard right, and -180 and 180 are directly behind the listener.
|
elevation |
rotation-degrees |
0..1 |
|
The elevation and pan elements allow placing of sound in a 3-D space relative to the listener. Both are expressed in degrees ranging from -180 to 180. For elevation, 0 is level with the listener, 90 is directly above, and -90 is directly below.
|
|
|
|
|
|
Referenced By
Example
<score-part id="P1">
<part-name>Flute 1</part-name>
<part-abbreviation>Fl. 1</part-abbreviation>
<score-instrument id="P1-I1">
<instrument-name>ARIA Player</instrument-name>
<virtual-instrument>
<virtual-library>Garritan Instruments for Finale</virtual-library>
<virtual-name>001. Woodwinds/1. Flutes/Flute Plr1</virtual-name>
</virtual-instrument>
</score-instrument>
<midi-device>Bank 1</midi-device>
<midi-instrument id="P1-I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
<volume>80</volume>
<pan>-70</pan>
</midi-instrument>
</score-part>
Definition
See score-part