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[])