javax.sound.sampled

クラスReverbType

java.lang.Object

javax.sound.sampled.ReverbType

public class ReverbType
extends Object

ReverbTypeクラスは、オーディオ信号に適用されるさまざまなリバーブ設定にアクセスするためのメソッドを提供します。

リバーブは、部屋の壁、天井、および床による音の反射をシミュレーションします。部屋の大きさや、部屋の表面の素材が音を吸収または反射する度合によって、音は消滅するまでに長時間跳ね返ることがあります。

ReverbTypeによって提供されるリバーブ・パラメータは、アーリー・リフレクションの遅延時間と強度、レイト・リフレクションの遅延時間と強度、および全体的な減衰時間から構成されています。アーリー・リフレクションは、部屋の表面から離れた直接信号の、最初の個々の下位リフレクションです。レイト・リフレクションは密度の高い、上位リフレクションで、部屋のリバーブの特徴となります。これら2つのリフレクション・タイプの開始の遅延時間により、全体的な大きさ、部屋の形状や中身の複雑さをリスナーに感じさせます。部屋が大きくなるほど、リフレクション遅延時間も長くなります。アーリー・リフレクションおよびレイト・リフレクションの強度が直接信号と比較され、反射された信号のゲイン(デシベル単位)が定義されます。これらの強度はリスナーに、部屋の表面と物体がどんな吸収性を持っているかを示します。減衰時間は、リバーブが知覚できなくなる(「事実上のゼロ」になる)まで指数的に減衰するのにかかる時間を定義します。表面が大きくなり吸収性が低くなるほど、遅延時間は長くなります。

ここで定義されるパラメータのセットは、システムが指定するリバーブの側面を全部は含んでいない場合があります。たとえば、Midi Manufacturer's Association (MMA)にはInteractive Audio Special Interest Group (IASIG)があり、このグループの3-D Working GroupはLevel 2 Spec (I3DL2)を定義しています。I3DL2はリバーブのフィルタ処理とリバーブ密度のコントロールをサポートします。これらのプロパティはJavaSound 1.0のリバーブ・コントロールの定義には含まれていません。このような場合、実装システムは定義されたリバーブ・コントロールを拡張してパラメータを追加するか、あるいはシステムの追加機能をここに述べるモデルに適合するように解釈します。

JavaSoundをI3DL2適合デバイスに実装する場合、次のようにします。

• フィルタ処理は使用不可(高周波減衰を0.0 dBに設定)
• 密度パラメータを最大と最小の中間に設定

次の表は、実装がリバーブ設定の表示セットに使用するパラメータ値を示しています。

リバーブのタイプとパラメータ

タイプ	減衰時間(ms)	レイト強度(dB)	レイト遅延(ms)	アーリー強度(dB)	アーリー遅延(ms)
Cavern	2250	-2.0	41.3	-1.4	10.3
Dungeon	1600	-1.0	10.3	-0.7	2.6
Garage	900	-6.0	14.7	-4.0	3.9
Acoustic Lab	280	-3.0	8.0	-2.0	2.0
Closet	150	-10.0	2.5	-7.0	0.6

導入されたバージョン:

1.3

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	ReverbType(String name, int earlyReflectionDelay, float earlyReflectionIntensity, int lateReflectionDelay, float lateReflectionIntensity, int decayTime) 指定されたリバーブ・パラメータを持つリバーブ・タイプを新しく構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
boolean	equals(Object obj) 指定されたオブジェクトがこのリバーブ・タイプに等しいかどうかを示し、オブジェクトが同一である場合はtrueを返します。
int	getDecayTime() レイト・リフレクション減衰が事実上のゼロになるまでの時間である減衰時間を取得します。
int	getEarlyReflectionDelay() アーリー・リフレクション遅延時間をマイクロ秒単位で返します。
float	getEarlyReflectionIntensity() アーリー・リフレクション強度をデシベル単位で返します。
int	getLateReflectionDelay() レイト・リフレクション遅延時間をマイクロ秒単位で返します。
float	getLateReflectionIntensity() レイト・リフレクション強度をデシベル単位で返します。
String	getName() このリバーブ・タイプの名前を取得します。
int	hashCode() ハッシュコード・メソッドをファイナライズします。
String	toString() 名前とパラメータの設定を含むリバーブ・タイプのString表現を提供します。

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

ReverbType

protected ReverbType(String name,
                     int earlyReflectionDelay,
                     float earlyReflectionIntensity,
                     int lateReflectionDelay,
                     float lateReflectionIntensity,
                     int decayTime)

指定されたリバーブ・パラメータを持つリバーブ・タイプを新しく構築します。

パラメータ:

name - 新しいリバーブ・タイプの名前、または長さゼロのString

earlyReflectionDelay - 新しいタイプのアーリー・リフレクション遅延時間(マイクロ秒単位)

earlyReflectionIntensity - 新しいタイプのアーリー・リフレクション強度(dB単位)

lateReflectionDelay - 新しいタイプのレイト・リフレクション遅延時間(マイクロ秒単位)

lateReflectionIntensity - 新しいタイプのレイト・リフレクション強度(dB単位)

decayTime - 新しいタイプの減衰時間(マイクロ秒単位)

メソッドの詳細

getName

public String getName()

このリバーブ・タイプの名前を取得します。

戻り値:

このリバーブ・タイプの名前

導入されたバージョン:

1.5

getEarlyReflectionDelay

public final int getEarlyReflectionDelay()

アーリー・リフレクション遅延時間をマイクロ秒単位で返します。直接信号が聞こえたときから最初のアーリー・リフレクションが聞こえたときまでの時間を示します。

戻り値:

このリバーブ・タイプのアーリー・リフレクション遅延時間(マイクロ秒単位)

getEarlyReflectionIntensity

public final float getEarlyReflectionIntensity()

アーリー・リフレクション強度をデシベル単位で返します。直接信号に対する最初のアーリー・リフレクションの振幅減衰を示します。

戻り値:

このリバーブ・タイプのアーリー・リフレクション強度(dB単位)

getLateReflectionDelay

public final int getLateReflectionDelay()

レイト・リフレクション遅延時間をマイクロ秒単位で返します。最初のアーリー・リフレクションが聞こえたときから最初のレイト・リフレクションが聞こえたときまでの時間を示します。

戻り値:

このリバーブ・タイプのレイト・リフレクション遅延時間(マイクロ秒単位)

getLateReflectionIntensity

public final float getLateReflectionIntensity()

レイト・リフレクション強度をデシベル単位で返します。直接信号に対する最初のレイト・リフレクションの振幅減衰を示します。

戻り値:

このリバーブ・タイプのレイト・リフレクション強度(dB単位)

getDecayTime

public final int getDecayTime()

レイト・リフレクション減衰が事実上のゼロになるまでの時間である減衰時間を取得します。事実上のゼロの値は実装によって異なります。

戻り値:

レイト・リフレクションの減衰時間(マイクロ秒単位)

equals

public final boolean equals(Object obj)

指定されたオブジェクトがこのリバーブ・タイプに等しいかどうかを示し、オブジェクトが同一である場合はtrueを返します。

オーバーライド:

equals、クラス: Object

パラメータ:

obj - 比較対象の参照オブジェクト

戻り値:

このリバーブ・タイプがobjと等しい場合はtrue、そうでない場合はfalse

関連項目:

Object.hashCode()、HashMap

hashCode

public final int hashCode()

ハッシュコード・メソッドをファイナライズします。

オーバーライド:

hashCode、クラス: Object

戻り値:

このオブジェクトのハッシュ・コード値。

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public final String toString()

名前とパラメータの設定を含むリバーブ・タイプのString表現を提供します。実際の文字列の内容はJava Soundの実装によって異なります。

オーバーライド:

toString、クラス: Object

戻り値:

リバーブ・タイプの名前と説明