javax.sound.midi

Class Patch

java.lang.Object

javax.sound.midi.Patch

public class Patch
extends Object

一个Patch对象表示在MIDI合成器上存储（加载）单个乐器的位置。 每个Instrument对象都有自己的Patch对象，它指定应该加载该仪器的内存位置。 该位置由银行索引和程序号（不是直接指向RAM中的特定地址或偏移量的任何方案）抽象地指定。 这是一个分层索引方案：MIDI提供多达16384个银行，每个银行最多包含128个程序位置。 例如，最小的合成器可能只有一笔工具，而该银行只有32个工具（程序）。

要选择什么乐器应该在特定的MIDI通道上播放音符，则使用两种MIDI消息来指定一个音色位置：银行选择命令和一个编程改变频道命令。 Java的声音相当于是programChange(int, int)的方法MidiChannel 。

另请参见：

Instrument ， Instrument.getPatch() ， MidiChannel.programChange(int, int) ， Synthesizer.loadInstruments(Soundbank, Patch[]) ， Soundbank ， Sequence.getPatchList()

构造方法摘要

构造方法

Constructor and Description
Patch(int bank, int program) 从指定的银行和程序编号构建一个新的补丁对象。

方法摘要

Modifier and Type	Method and Description
int	getBank() 返回包含其位置这个乐器的库的号码 Patch指定。
int	getProgram() 返回银行中指定的位置为Patch的 Patch索引。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

Patch

public Patch(int bank,
             int program)

从指定的银行和程序编号构建一个新的补丁对象。

参数

bank - 银行指数（从0到16383）

program - 程序索引（范围从0到127）

方法详细信息

getBank

public int getBank()

返回包含其位置这个乐器的库的号码 Patch指定。

结果

银行号码，范围为0至16383

另请参见：

MidiChannel.programChange(int, int)

getProgram

public int getProgram()

返回指数，银行内，其位置该仪器的 Patch规定。

结果

仪器的程序编号，范围为0到127

另请参见：

MidiChannel.getProgram() ， MidiChannel.programChange(int) ， MidiChannel.programChange(int, int)