JavaTM 2
Platform
Std. Ed. v1.4.0

javax.sound.midi
インタフェース Soundbank


public interface Soundbank

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

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

シンセサイザで使用される合成技術にはさまざまなものがあります。広く普及しているものとしては、録音されたサウンドのセグメントをループさせ、さまざまなピッチで再生する Wavetable 合成があります。Downloadable Sound (DLS) 形式では、Headspace Engine と同様に、録音されたサウンドのセグメントを使用します。Soundbanks および Instruments で Wavetable 合成 (または保存されたサウンドレコーディングを使用するその他の方法) を使用する場合は、これらの録音済みセグメントへのアクセスを提供するために、通常は 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

public String getName()
サウンドバンクの名前を取得します。

戻り値:
サウンドバンクの名前を表す String

getVersion

public String getVersion()
サウンドバンクのバージョン文字列を取得します。

戻り値:
サウンドバンクのバージョンを表す String

getVendor

public String getVendor()
サウンドバンクを提供する企業の名前を表す String を取得します。

戻り値:
ベンダー文字列

getDescription

public String getDescription()
表示用テキストによるサウンドバンクの説明を取得します。

戻り値:
サウンドバンクを説明する String

getResources

public SoundbankResource[] getResources()
サウンドバンクに含まれているインストゥルメント以外のリソースのリストを抽出します。

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

getInstruments

public Instrument[] getInstruments()
このサウンドバンクに含まれているインストゥルメントのリストを取得します。

戻り値:
この SoundBank に含まれている Instruments の配列。サウンドバンクにインストゥルメントが含まれていない場合は、長さ 0 の配列を返す
関連項目:
Synthesizer.getLoadedInstruments(), getInstrument(Patch)

getInstrument

public Instrument getInstrument(Patch patch)
指定した Patch から Instrument を取得します。

パラメータ:
patch - バンクインデックスおよびプログラムチェンジ番号を指定する Patch オブジェクト
戻り値:
要求したインストゥルメント。サウンドバンクにそのインストゥルメントが含まれていない場合は null
関連項目:
getInstruments(), Synthesizer.loadInstruments(Soundbank, Patch[])

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.