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)