Patch object represents a location, on a MIDI synthesizer, into
which a single instrument is stored (loaded). Every Instrument object
has its own Patch object that specifies the memory location into
which that instrument should be loaded. The location is specified abstractly
by a bank index and a program number (not by any scheme that directly refers
to a specific address or offset in RAM). This is a hierarchical indexing
scheme: MIDI provides for up to 16384 banks, each of which contains up to 128
program locations. For example, a minimal sort of synthesizer might have only
one bank of instruments, and only 32 instruments (programs) in that bank.
To select what instrument should play the notes on a particular MIDI channel,
two kinds of MIDI message are used that specify a patch location: a
bank-select command, and a program-change channel command. The Java Sound
equivalent is the
programChange(int, int) method of
MidiChannel.
Instrument, Instrument#getPatch(), MidiChannel#programChange(int, int), Synthesizer#loadInstruments(Soundbank, Patch[]), Soundbank, Sequence#getPatchList()
| Modifier and Type | Field and Description |
|---|---|
| private final int | bank
Bank index. |
| private final int | program
Program change number. |
| Access | Constructor and Description |
|---|---|
| public | Patch(int
the bank index (in the range from 0 to 16383) bank, int the program index (in the range from 0 to 127) program)Constructs a new patch object from the specified bank and program numbers. |
| Modifier and Type | Method and Description |
|---|---|
| public int | Returns: the bank number, whose range is from 0 to 16383Returns the number of the bank that contains the instrument whose
location this |
| public int | Returns: the instrument's program number, whose range is from 0 to 127Returns the index, within a bank, of the instrument whose location this
|
| bank | back to summary |
|---|---|
| private final int bank Bank index. | |
| program | back to summary |
|---|---|
| private final int program Program change number. | |
| Patch | back to summary |
|---|---|
| public Patch(int bank, int program) Constructs a new patch object from the specified bank and program numbers.
| |
| getBank | back to summary |
|---|---|
| public int getBank() Returns the number of the bank that contains the instrument whose
location this
| |
| getProgram | back to summary |
|---|---|
| public int getProgram() Returns the index, within a bank, of the instrument whose location this
| |