javax.sound.midi

クラス Patch

java.lang.Object

javax.sound.midi.Patch

public class Patch
extends Object

Patch オブジェクトは、単一のインストゥルメントが格納される (ロードされる) MIDI シンセサイザ上の位置を表します。すべての Instrument オブジェクトには、そのインストゥルメントがロードされるメモリー位置を指定する固有の Patch オブジェクトがあります。位置は (RAM の特定のアドレスまたは座標に直接関連するスキームによってではなく) バンクインデックスおよびプログラム番号によって抽象的に指定されます。これは階層型インデックススキームです。MIDI は最大 16384 バンクを提供し、各バンクには最大 128 のプログラム位置が含まれます。たとえば、もっとも小さな種類のシンセサイザはバンクを 1 つだけ持ち、そのバンクにあるインストゥルメント (プログラム) は 32 だけです。

特定の MIDI チャネルでどのインストゥルメントが音を演奏するかを選択するために、パッチ位置を指定する 2 種類の 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) 指定されたバンク番号とプログラム番号から新しいパッチオブジェクトを構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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)

指定されたバンク番号とプログラム番号から新しいパッチオブジェクトを構築します。

パラメータ:

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)