javax.sound.sampled

Class FloatControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.FloatControl

public abstract class FloatControl
extends Control

一个 FloatControl对象提供在一个范围内的浮点值的控制。浮子控制通常表示在图形用户界面的连续可调的物体如滑块或旋钮。 FloatControl实施控制的具体的子类，如增益和锅，在某种程度上影响一个应用程序可以操纵线的音频信号。的 FloatControl.Type内部类提供的，是用来确定浮动控制的几种常见类型的静态实例。

的FloatControl抽象类提供了设置和获取控制目前的浮点值的方法。其他方法获得可能的值范围和控制的分辨率（返回值之间的最小增量）。一些浮动控件允许斜坡在规定的时间段内，一个新的价值。FloatControl还包括方法返回的字符串标签最小，最大，和控制点的位置。

从以下版本开始：

一点三

另请参见：

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FloatControl.Type 该 FloatControl.Type内部类的一个实例标识一种浮动控制。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units) 用给定的参数构造一个新的浮控对象。
protected	FloatControl(FloatControl.Type type, float minimum, float maximum, float precision, int updatePeriod, float initialValue, String units, String minLabel, String midLabel, String maxLabel) 用给定的参数构造一个新的浮控对象

方法摘要

Modifier and Type	Method and Description
float	getMaximum() 获得允许的最大值。
String	getMaxLabel() 获得最大值的标签，如“右”或“满”。
String	getMidLabel() 获得中点值的标签，如“中心”或“默认”。
float	getMinimum() 获得允许的最小值。
String	getMinLabel() 获得最小值的标签，如“左”或“关闭”。
float	getPrecision() 获得控件的分辨率或粒度，在单位中的控制措施。
String	getUnits() 获取控件的值表示的单位的标签，如“数据库”或“每秒帧”。
int	getUpdatePeriod() 以获得最小的时间间隔，超过控制值可以在换班。
float	getValue() 获取此控件的当前值。
void	setValue(float newValue) 设置控件的当前值。
void	shift(float from, float to, int microseconds) 改变控制值从初始值的最终值线性在指定的时间、指定的微秒。
String	toString() 提供控件的字符串表示形式

Methods inherited from class javax.sound.sampled.Control

getType

Methods inherited from class java.lang.Object

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

Constructor Detail

FloatControl

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

用给定的参数构造一个新的浮控对象

参数

type -种控制这代表的浮动控制对象

minimum -为控制允许的最小值

maximum -为控制允许的最大值

precision -控制的分辨率或粒度。这是离散有效值之间的增量的大小。

updatePeriod的最小时间间隔，在微秒，该控制可以改变从一个离散值到下一个在 shift

initialValue -价值的控制开始建造时

units -中的控件的值表示单位的标签，如“DB”或“帧/秒”

minLabel -最小值的标签，如“左”或“关闭”

midLabel为中点值的标签，如“中心”或“默认”

maxLabel -最大值的标签，如“正确”或“全”

异常

IllegalArgumentException -如果 minimum大于 maximum或 initialValue不在允许范围内

FloatControl

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

用给定的参数构造一个新的浮控对象。用于最小值、最大值和中点值的标签被设置为零长度字符串。

参数

type -种控制这代表的浮动控制对象

minimum -为控制允许的最小值

maximum -为控制允许的最大值

precision -控制的分辨率或粒度。这是离散有效值之间的增量的大小。

updatePeriod的最小时间间隔，在微秒，该控制可以改变从一个离散值到下一个在 shift

initialValue -价值的控制开始建造时

units -中的控件的值表示单位的标签，如“DB”或“帧/秒”

异常

IllegalArgumentException -如果 minimum大于 maximum或 initialValue不在允许范围内

方法详细信息

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()

获取控件的值表示的单位的标签，如“数据库”或“每秒帧”。

结果

单位标签，或一零个长度的字符串，如果没有标签

getMinLabel

public String getMinLabel()

获得最小值的标签，如“左”或“关闭”。

结果

最小值标签，或一零个长度的字符串，如果没有标签*已被设置

getMidLabel

public String getMidLabel()

获得中点值的标签，如“中心”或“默认”。

结果

中点值标签，或一零个长度的字符串，如果没有标签*已被设置

getMaxLabel

public String getMaxLabel()

获得最大值的标签，如“右”或“满”。

结果

如果没有设置标签*，则最大值标签，或一零个长度的字符串

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 -在微秒的转变最大持续时间

异常

IllegalArgumentException -如果 from或 to值不在允许范围内

另请参见：

getUpdatePeriod()

toString

public String toString()

提供控件的字符串表示形式

重写：

toString 方法重写，继承类 Control

结果

一个字符串描述