- java.lang.Object
-
- javax.sound.midi.Patch
-
public class Patch extends Object
APatch
object represents a location, on a MIDI synthesizer, into which a single instrument is stored (loaded). EveryInstrument
object has its ownPatch
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 ofMidiChannel
.
-
-
Constructor Summary
Constructors Constructor and Description Patch(int bank, int program)
Constructs a new patch object from the specified bank and program numbers.
-
Method Summary
Methods Modifier and Type Method and Description int
getBank()
Returns the number of the bank that contains the instrument whose location thisPatch
specifies.int
getProgram()
Returns the index, within a bank, of the instrument whose location thisPatch
specifies.
-
-
-
Constructor Detail
-
Patch
public Patch(int bank, int program)
Constructs a new patch object from the specified bank and program numbers.- Parameters:
bank
- the bank index (in the range from 0 to 16383)program
- the program index (in the range from 0 to 127)
-
-
Method Detail
-
getBank
public int getBank()
Returns the number of the bank that contains the instrument whose location thisPatch
specifies.- Returns:
- the bank number, whose range is from 0 to 16383
- See Also:
MidiChannel.programChange(int, int)
-
getProgram
public int getProgram()
Returns the index, within a bank, of the instrument whose location thisPatch
specifies.- Returns:
- the instrument's program number, whose range is from 0 to 127
- See Also:
MidiChannel.getProgram()
,MidiChannel.programChange(int)
,MidiChannel.programChange(int, int)
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/sound/midi/patch.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.