JavaTM 2 Platform
Standard Ed. 5.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)
          Obtains an Instrument from the given Patch.
 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)
Obtains an Instrument from the given Patch.

パラメータ:
patch - a Patch object specifying the bank index and program change number
戻り値:
the requested instrument, or null if the sound bank doesn't contain that instrument
関連項目:
getInstruments(), Synthesizer.loadInstruments(Soundbank, Patch[])

JavaTM 2 Platform
Standard Ed. 5.0

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

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。