Element: midi-instrument
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
- Complex Type score-part
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>
