Java 2 Platform SE 1.3: クラス SoundbankResource

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.sound.midi
クラス SoundbankResource

java.lang.Object
  |
  +--javax.sound.midi.SoundbankResource

直系の既知のサブクラス:: Instrument

public abstract class SoundbankResource
extends Object

SoundbankResource とは、Soundbank に格納されているオーディオリソースのことです。一般的なサウンドバンクリソースには、以下のものが含まれます。

インストゥルメント。インストゥルメントはさまざまな方法で指定できます。ただし、すべてのサウンドバンクはインストゥルメントを定義するための何らかの機構を備えています。サウンドバンクは、インストゥルメントを定義する際にそこに格納されている他のリソースを参照する場合があります。それぞれのインストゥルメントには、MIDI メッセージでそのインストゥルメントを参照できる MIDI プログラムおよびバンクを指定する Patch があります。インストゥルメント情報は、Instrument オブジェクトに保存されている場合があります。
オーディオサンプル。サンプルは通常、サンプリングされたオーディオの波形で、数分の 1 秒～数秒程度の長さを持つ短いサウンドレコーディングが収められています。これらのオーディオサンプルは、Synthesizer で MIDI コマンドに基づくサウンドの合成に使用されたり、アプリケーションで使用するために抽出されたりする場合があります (この用語は、ミュージシャンが単一の断片的なサンプルというより、一連の連続したオーディオサンプルやフレームを全体として「サンプル」と呼んでいることを反映している)。オーディオサンプルのデータクラスは、オーディオサンプルデータ自体とその解釈方法に関する情報 (オーディオデータの形式) をカプセル化した、AudioInputStream などのオブジェクトです。
組み込み処理。サウンドバンクには、Sequence などのデータオブジェクトに格納された組み込みソングデータが含まれている場合があります。

Wavetable 合成やそれに関連する技術を使用するシンセサイザは、ノート (音符) を合成する際、特に初めに録音された現実のインストゥルメント (楽器) をエミュレートする場合に、サンプルを用いてオーディオを再生します。ただし、Instruments と Soundbank のサンプルは 1 対 1 に対応しているとは限りません。1 つの Instrument で複数の SoundbankResources (通常はピッチや明るさの異なるノート) を使用することができます。また、複数の Instrument で同じサンプルを使用することもできます。

コンストラクタの概要

protected SoundbankResource(Soundbank soundBank, String name, Class dataClass)
          指定したサウンドバンクおよび Wavetable のインデックスから新しい SoundbankResource を構築します (SoundbankResource's の名前、サンプリングされたオーディオデータ、およびインストゥルメントはサブクラスで設定)。

メソッドの概要

abstract Object getData()
          この SoundbankResource に格納されているオーディオサンプルを取得します。

Class getDataClass()
          このサンプルでそのデータを表すために使用されているクラスを取得します。

String getName()
          リソースの名前を取得します。

Soundbank getSoundbank()
          この SoundbankResource が格納されているサウンドバンクを取得します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SoundbankResource

protected SoundbankResource(Soundbank soundBank,
                            String name,
                            Class dataClass)

指定したサウンドバンクおよび Wavetable のインデックスから新しい SoundbankResource を構築します (SoundbankResource's の名前、サンプリングされたオーディオデータ、およびインストゥルメントはサブクラスで設定)。

パラメータ:: soundBank - この SoundbankResource が格納されているサウンドバンク; name - サンプルの名前; dataClass - サンプルのデータを表すために使用されているクラス
関連項目:: getSoundbank(), getName(), getDataClass(), getData()

メソッドの詳細

getSoundbank

public Soundbank getSoundbank()

この SoundbankResource が格納されているサウンドバンクを取得します。

戻り値:: この SoundbankResource が格納されているサウンドバンク

getName

public String getName()

リソースの名前を取得します。一般にこの名前は、それに基づいてインストゥルメントを選択できるように、リソースを説明する、そのサウンドバンク内で一意の文字列にする必要があります。

戻り値:: インストゥルメントの名前

getDataClass

public Class getDataClass()

このサンプルでそのデータを表すために使用されているクラスを取得します。getData で返されるオブジェクトはこのクラスのオブジェクトです。この SoundbankResource オブジェクトがそのデータに直接アクセスできない場合は、null が返されます。

戻り値:: サンプルのデータを表すために使用されているクラス。データにアクセスできない場合は null

getData

public abstract Object getData()

この SoundbankResource に格納されているオーディオサンプルを取得します。返されるオブジェクトのタイプは具象クラスの実装に依存し、getDataClass で照会できる場合もあります。

戻り値:: サンプリングされたオーディオデータを格納するオブジェクト
関連項目:: getDataClass()

概要