FloatControl JDK 1.6)

Description

publicabstract abstract class FloatControl

A FloatControl object provides control over a range of floating-point values.

A FloatControl object provides control over a range of floating-point values. Float controls are often represented in graphical user interfaces by continuously adjustable objects such as sliders or rotary knobs. Concrete subclasses of FloatControl implement controls, such as gain and pan, that affect a line's audio signal in some way that an application can manipulate. The FloatControl.Type inner class provides static instances of types that are used to identify some common kinds of float control.

The FloatControl abstract class provides methods to set and get the control's current floating-point value. Other methods obtain the possible range of values and the control's resolution (the smallest increment between returned values). Some float controls allow ramping to a new value over a specified period of time. FloatControl also includes methods that return string labels for the minimum, maximum, and midpoint positions of the control.

See also: Line.getControls() Line.isControlSupported(javax.sound.sampled.Control.Type)

Constructors

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

Constructs a new float control object with the given parameters.

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

Constructs a new float control object with the given parameters

Methods

Hide/Show inherited methods

public float getMaximum ()

Obtains the maximum value permitted.

public String getMaxLabel ()

Obtains the label for the maximum value, such as "Right" or "Full."

public String getMidLabel ()

Obtains the label for the mid-point value, such as "Center" or "Default."

public float getMinimum ()

Obtains the minimum value permitted.

public String getMinLabel ()

Obtains the label for the minimum value, such as "Left" or "Off."

public float getPrecision ()

Obtains the resolution or granularity of the control, in the units that the control measures.

public Type getType () [Inherited From Control]

Obtains the control's type.

public String getUnits ()

Obtains the label for the units in which the control's values are expressed, such as "dB" or "frames per second."

public int getUpdatePeriod ()

Obtains the smallest time interval, in microseconds, over which the control's value can change during a shift.

public float getValue ()

Obtains this control's current value.

public void setValue (float newValue)

Sets the current value for the control.

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

Changes the control value from the initial value to the final value linearly over the specified time period, specified in microseconds.

public String toString () [Overrides Control]

Provides a string representation of the control