モジュール java.desktop
パッケージ 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[])