javax.sound.midi

インタフェースSoundbank

public interface Soundbank

Soundbankには、Synthesizerにロードできる一連のInstrumentsが含まれています。Java SoundのSoundbankはMIDIバンクとは異なることに注意してください。MIDIでは、1バンク当たり最大128インストゥルメント(プログラム、パッチ、音色とも呼ばれる)で最大16383バンクを使用できます。これに対しSoundbankは、Soundbank内のインストゥルメントがPatchオブジェクトによってMIDIプログラム番号とMIDIバンク番号の両方でインデックスが作成されるため、16383×128種類のインストゥルメントを使用できます。そのため、SoundbankはMIDIバンクの集合体と考えることもできます。

Soundbankでは、サウンド・バンクの名前、製造元、バージョン番号、および説明を含んだStringオブジェクトを返すメソッドが提供されます。これらの文字列の具体的な内容および形式は、実装者が決定します。

シンセサイザで使用される合成技術にはさまざまなものがあります。広く普及しているものとしては、録音されたサウンドのセグメントをループさせ、さまざまなピッチで再生するWavetable合成があります。Downloadable Sound (DLS)形式では、Headspace Engineと同様に、録音されたサウンドのセグメントを使用します。Wavetable合成(または保存されたサウンド・レコーディングのその他の使用法)に基づくSoundbanksおよびInstrumentsは、これらの録音済みセグメントへのアクセスを提供するために、通常はgetResources()メソッドを実装するようにしてください。このメソッドはオプションですが、その合成技術がサンプリングされたサウンドを利用しない(たとえばFM合成や物理モデリング)場合や、サンプリングされたサウンドを利用しているが、実装者がサンプルにアクセスできないようにしている場合には、長さ0の配列を返すことができます。

関連項目:

Synthesizer.getDefaultSoundbank()、Synthesizer.isSoundbankSupported(javax.sound.midi.Soundbank)、Synthesizer.loadInstruments(Soundbank, Patch[])、Patch、Instrument、SoundbankResource

メソッドのサマリー

修飾子と型	メソッドと説明
String	getDescription() サウンド・バンクのテキスト形式の説明を取得します(表示向け)。
Instrument	getInstrument(Patch patch) 指定したPatchからInstrumentを取得します。
Instrument[]	getInstruments() このサウンド・バンクに含まれているインストゥルメントのリストを取得します。
String	getName() サウンド・バンクの名前を取得します。
SoundbankResource[]	getResources() サウンド・バンクに含まれているインストゥルメント以外のリソースのリストを抽出します。
String	getVendor() サウンド・バンクを提供する企業の名前を表すstringを取得します。
String	getVersion() サウンド・バンクのバージョン文字列を取得します。

メソッドの詳細

getName

String getName()

サウンド・バンクの名前を取得します。

戻り値:

サウンド・バンクの名前を表すString

getVersion

String getVersion()

サウンド・バンクのバージョン文字列を取得します。

戻り値:

サウンド・バンクのバージョンを表すString

getVendor

String getVendor()

サウンド・バンクを提供する企業の名前を表すstringを取得します。

戻り値:

ベンダー文字列

getDescription

String getDescription()

サウンド・バンクのテキスト形式の説明を取得します(表示向け)。

戻り値:

サウンド・バンクを説明するString

getResources

SoundbankResource[] getResources()

サウンド・バンクに含まれているインストゥルメント以外のリソースのリストを抽出します。

戻り値:

インストゥルメントを除くリソースの配列。サウンド・バンクにインストゥルメント以外のリソースが含まれていない場合は、長さ0の配列を返す。

getInstruments

Instrument[] getInstruments()

このサウンド・バンクに含まれているインストゥルメントのリストを取得します。

戻り値:

このSoundBankに含まれているInstrumentsの配列。サウンド・バンクにインストゥルメントが含まれていない場合は、長さ0の配列を返す。

関連項目:

Synthesizer.getLoadedInstruments(), getInstrument(Patch)

getInstrument

Instrument getInstrument(Patch patch)

指定したPatchからInstrumentを取得します。

パラメータ:

patch - バンク・インデックスおよびプログラム・チェンジ番号を指定するPatchオブジェクト

戻り値:

要求したインストゥルメント。サウンド・バンクにそのインストゥルメントが含まれていない場合はnull

関連項目:

getInstruments(), Synthesizer.loadInstruments(Soundbank, Patch[])