javax.sound.sampled
類別 FloatControl

java.lang.Object
  javax.sound.sampled.Control
      javax.sound.sampled.FloatControl

public abstract class FloatControl
extends Control

FloatControl 物件提供對浮點值範圍的控制。Float 控制元件常常通過滑塊或旋鈕之類別的可連續調節物件在圖形使用者介面中表示。FloatControl 的具體子類別實作諸如 gain 和 pan 之類別的控制元件，這些控制元件會以應用程序可以操作的方式影響行的音頻信號。FloatControl.Type 內部類別提供用於標識一些常見 float 控制元件的那些型別的靜態實例。

FloatControl 抽象類別提供設置和獲取控制元件的當前浮點值的方法。其他方法獲得可能的值範圍和控制元件的分辨率（所返回值之間的最小增量）。一些 float 控制元件允許將新值延伸至指定時間段。FloatControl 還包括一些方法，這些方法返回用於該控制元件的最大、最小和中點位置的字元串標籤。

從以下版本開始：

1.3

另請參見：

Line.getControls(), Line.isControlSupported(javax.sound.sampled.Control.Type)

巢狀類別摘要

static class

FloatControl.Type FloatControl.Type 內部類別的實例標識了某種 float 控制元件。

建構子摘要

protected	FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units) 建構具有給定參數的新 float 控制元件物件。
protected	FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units, String minLabel, String midLabel, String maxLabel) 建構具有給定參數的新 float 控制元件物件

方法摘要

float	getMaximum() 獲得所允許的最大值。
String	getMaxLabel() 獲得最大值的標籤，如 "Right" 或 "Full"。
String	getMidLabel() 獲得中點值的標籤，如 "Center" 或 "Default"。
float	getMinimum() 獲得所允許的最小值。
String	getMinLabel() 獲得最小值的標籤，如 "Left" 或 "Off"。
float	getPrecision() 獲得該控制元件的分辨率或粒度，以該控制元件測量的單位為準。
String	getUnits() 獲得表示控制元件值的單位標籤，如 "dB" 或 "frames per second"。
int	getUpdatePeriod() 獲得最小時間間隔（以微秒為單位），在此段時間內，控制元件值可以在移動期間更改。
float	getValue() 獲得此控制元件的當前值。
void	setValue(float newValue) 設置控制元件的當前值。
void	shift(float from, float to, int microseconds) 在整個指定的時間內線性地將控制元件值從初始值更改為最終值，以微秒為單位進行指定。
String	toString() 提供控制元件的字元串表示形式

從類別 javax.sound.sampled.Control 繼承的方法

getType

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

FloatControl

protected FloatControl(FloatControl.Type type,
                       float minimum,
                       float maximum,
                       float precision,
                       int updatePeriod,
                       float initialValue,
                       String units,
                       String minLabel,
                       String midLabel,
                       String maxLabel)

建構具有給定參數的新 float 控制元件物件

參數：

type - 由此 float 控制元件物件表示的控制元件種類別

minimum - 該控制元件允許的最小值

maximum - 該控制元件允許的最大值

precision - 該控制元件的分辨率或粒度。這是離散有效值之間的增量大小。

updatePeriod - 最小時間間隔（以微秒為單位），在此段時間內，控制元件可以在 shift 期間從一個離散值更改為下一個離散值

initialValue - 建構控制元件時該控制元件的起始值

units - 用來表示控制元件值的單位的標籤，如 "dB" 或 "frames per second"

minLabel - 最小值的標籤，如 "Left" 或 "Off"

midLabel - 中點值的標籤，如 "Center" 或 "Default"

maxLabel - 最大值的標籤，如 "Right" 或 "Full"

FloatControl

protected FloatControl(FloatControl.Type type,
                       float minimum,
                       float maximum,
                       float precision,
                       int updatePeriod,
                       float initialValue,
                       String units)

建構具有給定參數的新 float 控制元件物件。將最小、最大和中點值的標籤設置為零長度字元串。

參數：

type - 由此 float 控制元件物件表示的控制元件種類別

minimum - 該控制元件允許的最小值

maximum - 該控制元件允許的最大值

precision - 該控制元件的分辨率或粒度。這是離散有效值之間的增量大小。

updatePeriod - 最小時間間隔（以微秒為單位），在此段時間內，控制元件可以在 shift 期間從一個離散值更改為下一個離散值

initialValue - 建構控制元件時該控制元件的起始值

units - 表示控制元件值的音位標籤，如 "dB" 或 "frames per second"

方法詳細資訊

setValue

public void setValue(float newValue)

設置控制元件的當前值。預設實作只根據指示設置該值。如果指示的值大於最大值，或小於最小值，則拋出 IllegalArgumentException。有些控制元件要求提前打開它們的行，以防受設置值受影響。

參數：

newValue - 所需的新值

拋出：

IllegalArgumentException - 如果指示的值不在允許的範圍內

getValue

public float getValue()

獲得此控制元件的當前值。

返回：

當前值

getMaximum

public float getMaximum()

獲得所允許的最大值。

返回：

所允許的最大值

getMinimum

public float getMinimum()

獲得所允許的最小值。

返回：

所允許的最小值

getUnits

public String getUnits()

獲得表示控制元件值的單位標籤，如 "dB" 或 "frames per second"。

返回：

單位標籤；如果沒有標籤，則返回零長度字元串

getMinLabel

public String getMinLabel()

獲得最小值的標籤，如 "Left" 或 "Off"。

返回：

最小值標籤；如果沒有設置標籤，則返回零長度字元串

getMidLabel

public String getMidLabel()

獲得中點值的標籤，如 "Center" 或 "Default"。

返回：

中點值標籤；如果沒有設置標籤，則返回零長度字元串

getMaxLabel

public String getMaxLabel()

獲得最大值的標籤，如 "Right" 或 "Full"。

返回：

最大值標籤；如果沒有設置標籤，則返回零長度字元串

getPrecision

public float getPrecision()

獲得該控制元件的分辨率或粒度，以該控制元件測量的單位為準。精度是受支持浮點值的集合中此控制元件的離散有效值之間的增量大小。

返回：

控制元件的精度

getUpdatePeriod

public int getUpdatePeriod()

獲得最小時間間隔（以微秒為單位），在此段時間內，控制元件值可以在移動期間更改。更新週期是控制元件用來在移動期間更新值的頻率的倒數。如果實作不支持隨時間移動的值，則它應立即將控制元件的值設置為最終值，並從此方法返回 -1。

返回：

以微秒為單位的更新週期；如果隨著時間的串流逝，移動變得不受支持，則返回 -1

另請參見：

shift(float, float, int)

shift

public void shift(float from,
                  float to,
                  int microseconds)

在整個指定的時間內線性地將控制元件值從初始值更改為最終值，以微秒為單位進行指定。此方法可以不受阻塞地返回；它不會等到移動完成。實作應該在指定時間內完成操作。預設實作只能立即將該值更改最終值。

參數：

from - 移動開始時的初始值

to - 移動之後的最終值

microseconds - 移動持續的最長時間（以微秒為單位）

另請參見：

getUpdatePeriod()

toString

public String toString()

提供控制元件的字元串表示形式

覆寫：

類別 Control 中的 toString

返回：

字元串描述