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) 特定のサウンドバンク、バンクインデックス、およびプログラムインデックスから新しい 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)

特定のサウンドバンク、バンクインデックス、およびプログラムインデックスから新しい MIDI インストゥルメントを構築します。続けてインストゥルメントのロード要求がある場合は、サウンドバンクがこれらのインデックスを使ってコンテンツを検索し、Patch がインデックスに一致するインストゥルメント (つまり、いま構築されたインストゥルメント) が、示されたバンクおよびプログラムの位置でシンセサイザにロードされます。

パラメータ:

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

bank - バンクインデックス (0 〜 127)

program - プログラム変更番号 (0 〜 127)

関連項目:

Synthesizer.loadInstrument(Instrument)

メソッドの詳細

getPatch

public Patch getPatch()

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

戻り値:

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