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)