機械翻訳について

javafx.scene.media

クラスAudioEqualizer

java.lang.Object

javafx.scene.media.AudioEqualizer

public final class AudioEqualizer
extends Object

AudioEqualizerクラスは、メディア・プレイヤに音声等化コントロールを提供します。 これには、EqualizerBand要素のObservableListが含まれます。 各AudioEqualizerインスタンスはMediaPlayerに接続され、MediaPlayer.getAudioEqualizerメソッドを使用して取得できます。

導入されたバージョン:

JavaFX 2.0

関連項目:

MediaPlayer、EqualizerBand

プロパティのサマリー

Type	プロパティと説明
BooleanProperty	enabled AudioEqualizerを有効にするかどうか。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static int	MAX_NUM_BANDS AudioEqualizerに含めることができるバンドの最大数。

メソッドのサマリー

修飾子と型	メソッドと説明
BooleanProperty	enabledProperty() AudioEqualizerを有効にするかどうか。
ObservableList<EqualizerBand>	getBands() EqualizerBand要素を含むObservableList。
boolean	isEnabled() AudioEqualizerの有効化状態を返します。
void	setEnabled(boolean value) AudioEqualizerを有効または無効にします。

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

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

プロパティの詳細

enabled

public BooleanProperty enabledProperty

AudioEqualizerを有効にするかどうか。 デフォルト値はtrue。

関連項目:

isEnabled()、setEnabled(boolean)

フィールドの詳細

MAX_NUM_BANDS

public static final int MAX_NUM_BANDS

AudioEqualizerに含めることができるバンドの最大数。 現在の実装では、この値は64です。

関連項目:

定数フィールド値

メソッドの詳細

getBands

public final ObservableList<EqualizerBand> getBands()

EqualizerBand要素を含むObservableList。 シーケンスのコンテンツは、EqualizerBand要素を追加または削除することによって変更できます。 要素を追加するとき、ユーザーはIllegalArgumentExceptionを捕捉できるようにしておく必要があります。これは、内部的なリストがVetoableObservableListであり、新しく追加されたインスタンスが有効でない場合は、リストに加えられるすべての変更が拒否される可能性があるためです。

有効なEqualizerBandインスタンスの制約は次のとおりです。

• EqualizerBand.centerFrequency > 0
• EqualizerBand.bandwidth > 0
• EqualizerBand.MIN_GAIN ≤ EqualizerBand.gain ≤ EqualizerBand.MAX_GAIN

デフォルトのバンド・セットは次の表に示すとおりで、すべてのバンドがユニティ・ゲイン(0 dB)を持ちます。

バンド・インデックス	中心周波数(Hz)	帯域幅(Hz)
0	32	19
1	64	39
2	125	78
3	250	156
4	500	312
5	1000	625
6	2000	1250
7	4000	2500
8	8000	5000
9	16000	10000

戻り値:

EqualizerBand要素を含むObservableList。

例外:

IllegalArgumentException

setEnabled

public final void setEnabled(boolean value)

AudioEqualizerを有効または無効にします。 有効化されたプロパティがfalseに設定されている場合は、AudioEqualizer設定は保持されますが、再生時には考慮されず、すべてのEqualizerBand.gainプロパティをゼロに設定することと同等になります。

isEnabled

public final boolean isEnabled()

AudioEqualizerの有効化状態を返します。

戻り値:

AudioEqulizerが有効な場合はtrue、そうでない場合はfalse。

enabledProperty

public BooleanProperty enabledProperty()

AudioEqualizerを有効にするかどうか。 デフォルト値はtrue。

関連項目:

isEnabled()、setEnabled(boolean)