You are here: MusicXML Reference > Score Schema (XSD) > Elements > Element: midi-instrument

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
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

 

MusicXML Documentation Home
Last built 2/20/2015

7007 Winchester Circle, Suite 140

Boulder, CO 80301