javax.sound.midi

クラス SoundbankResource

java.lang.Object

javax.sound.midi.SoundbankResource

直系の既知のサブクラス:

Instrument

public abstract class SoundbankResource
extends Object

SoundbankResource とは、Soundbank に格納されているオーディオリソースのことです。一般的なサウンドバンクリソースには、次のものが含まれます。

• インストゥルメント。インストゥルメントはさまざまな方法で指定できる。ただし、すべてのサウンドバンクはインストゥルメントを定義するための何らかのメカニズムを備えている。サウンドバンクは、インストゥルメントを定義する際にそこに格納されているほかのリソースを参照する場合がある。それぞれのインストゥルメントには、MIDI メッセージでそのインストゥルメントを参照できる MIDI プログラムおよびバンクを指定する Patch がある。インストゥルメント情報は、Instrument オブジェクトに保存されている場合がある。
• オーディオサンプル。サンプルは通常、サンプリングされたオーディオの波形で、数分の 1 秒から数秒程度の長さを持つ短いサウンドレコーディングが収められている。これらのオーディオサンプルは、Synthesizer で MIDI コマンドに応答してサウンドを合成するのに使用されたり、アプリケーションで使用するために抽出されたりする場合がある。(この用語は、ミュージシャンが単一の断片的なサンプルではなく、一連の連続したオーディオサンプルやフレームを全体として「サンプル」と呼んでいることを反映している。)オーディオサンプルのデータクラスは、オーディオサンプルデータ自体とその解釈方法に関する情報 (オーディオデータの形式) をカプセル化した、AudioInputStream などのオブジェクトになる。
• 組み込み処理。サウンドバンクには、Sequence などのデータオブジェクトに格納された組み込みソングデータが含まれている場合がある。

Wavetable 合成やそれに関連する技術を使用するシンセサイザは、ノート (音符) を合成する際、特に初めに録音された現実のインストゥルメント (楽器) をエミュレートする場合に、サンプルを用いてオーディオを再生します。ただし、Instruments と、Soundbank のサンプルは 1 対 1 に対応しているとは限りません。1 つの Instrument で複数の SoundbankResources (通常はピッチや明るさの異なるノート) を使用することができます。また、複数の Instrument で同じサンプルを使用することもできます。

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

コンストラクタ

修飾子	コンストラクタと説明
protected	SoundbankResource(Soundbank soundBank, String name, Class<?> dataClass) 指定したサウンドバンクおよび Wavetable のインデックスから新しい SoundbankResource を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract Object	getData() この SoundbankResource に格納されているオーディオサンプルを取得します。
Class<?>	getDataClass() このサンプルでそのデータを表すために使用されているクラスを取得します。
String	getName() リソース名を取得します。
Soundbank	getSoundbank() この SoundbankResource が格納されているサウンドバンクを取得します。

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

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

コンストラクタの詳細

SoundbankResource

protected SoundbankResource(Soundbank soundBank,
                 String name,
                 Class<?> dataClass)

指定したサウンドバンクおよび Wavetable のインデックスから新しい SoundbankResource を構築します。(SoundbankResource's の名前、サンプリングされたオーディオデータ、およびインストゥルメントはサブクラスで設定します。)

パラメータ:

soundBank - この SoundbankResource が格納されているサウンドバンク

name - サンプルの名前

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

関連項目:

getSoundbank(), getName(), getDataClass(), getData()

メソッドの詳細

getSoundbank

public Soundbank getSoundbank()

この SoundbankResource が格納されているサウンドバンクを取得します。

戻り値:

この SoundbankResource が格納されているサウンドバンク

getName

public String getName()

リソース名を取得します。これは、通常、リソースを説明する文字列になります。

戻り値:

インストゥルメントの名前

getDataClass

public Class<?> getDataClass()

このサンプルでそのデータを表すために使用されているクラスを取得します。getData で返されるオブジェクトはこのクラスのオブジェクトです。この SoundbankResource オブジェクトがそのデータに直接アクセスできない場合は、null が返されます。

戻り値:

サンプルのデータを表すために使用されているクラス、データにアクセスできない場合は null

getData

public abstract Object getData()

この SoundbankResource に格納されているオーディオサンプルを取得します。返されるオブジェクトの型は具象クラスの実装に依存し、getDataClass で照会できる場合もあります。

戻り値:

サンプリングされたオーディオデータを格納するオブジェクト

関連項目:

getDataClass()