javax.sound.midi

クラスInstrument

java.lang.Object

javax.sound.midi.SoundbankResource

javax.sound.midi.Instrument

public abstract class Instrument
extends SoundbankResource

インストゥルメントは一定のパラメータ設定値を持ったサウンド合成アルゴリズムで、通常、実際の楽器をエミュレートしたり、特種なサウンド効果を実現するために設計されています。インストゥルメントは通常、サウンド・バンクと呼ばれるコレクションに格納されます。インストゥルメントを使用して音を出すには、最初にインストゥルメントをシンセサイザにロードしてから、プログラム変更コマンドを使用して、インストゥルメントを使用するチャネルを1つまたは複数選択する必要があります。それらのチャネルでその後受信されたMIDIノートが、選択したインストゥルメントのサウンドを使用して演奏されます。

関連項目:

Soundbank、Soundbank.getInstruments()、Patch、Synthesizer.loadInstrument(Instrument)、MidiChannel.programChange(int, int)

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	Instrument(Soundbank soundbank, Patch patch, String name, Class<?> dataClass) 指定されたPatchから新しいMIDIインストゥルメントを作成します。

メソッドのサマリー

修飾子と型	メソッドと説明
Patch	getPatch() このインストゥルメントがシンセサイザに格納されるバンク番号とプログラム番号を示すPatchオブジェクトを取得します。

クラス javax.sound.midi.SoundbankResourceから継承されたメソッド

getData, getDataClass, getName, getSoundbank

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

Instrument

protected Instrument(Soundbank soundbank,
                     Patch patch,
                     String name,
                     Class<?> dataClass)

指定されたPatchから新しいMIDIインストゥルメントを作成します。その後、作成されたインストゥルメントをロードする要求が発行されると、サウンド・バンク内でこのインストゥルメントのPatchが検索されます。続いて、サウンド・バンクのシンセサイザと、Patchオブジェクトで指定されたプログラム位置に、このインストゥルメントがロードされます。

パラメータ:

soundbank - インストゥルメントを含むサウンド・バンク

patch - このインストゥルメントのパッチ

name - このインストゥルメントの名前

dataClass - サンプルのデータを表すために使用されているクラス。

関連項目:

Synthesizer.loadInstrument(Instrument)

メソッドの詳細

getPatch

public Patch getPatch()

このインストゥルメントがシンセサイザに格納されるバンク番号とプログラム番号を示すPatchオブジェクトを取得します。

戻り値:

このインストゥルメントのパッチ