Voice Instrument Number

Controls: Sgram/PT Dialog >> Pitch-to-MIDI >> Setup
Changes: Iv=n
Macros: MIDIinst1-8
Table: General MIDI Instruments

This control appears for each voice in the Pitch-to-MIDI dialog, and also at the top of each individual Voice Setup dialog.

There are 128 General MIDI Instruments that almost every synthesizer supports, numbered 0-127.

When you change the number on this control, the long adjacent Instrument On/Off button changes to the name of the new instrument.

You can see the General MIDI Instruments list at any time by right-clicking the Instrument Number or Instrument On/Off controls for Voices 2 through 8 in the Pitch-to-MIDI dialog. (Not Voice 1, which provides this control Help, as do the Voice Setup controls.)

MIDI Changes Script:

Use Iv=n to set the Voice v Instrument Number to the value n, which is an unsigned integer that will be limited to the range of 0 to 127. For example, I2=12 sets Voice 2 to use Instrument Number 12, which is Marimba.

Tip: The n value can be any valid variable or expression, including current MIDI control values, random values, current computer keyboard states or mouse position, input or buffered notes, or oscillators.

You can use "voice" 9 to set all voices to the same Instrument number.

If you look at the General MIDI Instruments list, you will see that they are grouped by families. For example Reed instruments are numbers 64 (Soprano Sax) to 71 (Clarinet). So to choose one Reed instrument at random for Voice 2, use I2=?(64,71).

See Random Selection from a Buffer under the Changes Script Random Values topic for a way to randomly select from an arbitrary assortment of instruments.

Macro Notes:

MIDIinst2=12 sets Voice 2 to use Instrument Number 12 (Marimba). MIDIinst2=>1 increments the Instrument Number by 1, while MIDIinst2=>-1 decrements it.

However, Changes scripts are recommended for this purpose.

See also MIDI Voice Setup Dialogs, Pitch-to-MIDI dialog, Pitch Track Toolbox - Overview