javax.sound.midi
類別 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 Sound 為 MidiChannel 的 programChange(int, int) 方法。

另請參見：

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

建構子摘要

Patch(int bank, int program)
從指定的資源庫和程序號建構一個新的 patch 物件。

方法摘要

int	getBank() 返回包含該 Patch 指定其位置樂器的資源庫的號碼。
int	getProgram() 返回該 Patch 指定其位置的樂器在資源庫中的索引號。

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

Patch

public Patch(int bank,
             int program)

從指定的資源庫和程序號建構一個新的 patch 物件。

參數：

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)