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()