protected FloatControl(Type type,
    float minimum,
    float maximum,
    float precision,
    int updatePeriod,
    float initialValue,
    String units) 
{
        this(type, minimum, maximum, precision, updatePeriod,
                initialValue, units, "", "", "");
}

Constructs a new float control object with the given parameters. The labels for the minimum, maximum, and mid-point values are set to zero-length strings.

Parameters:

type - the kind of control represented by this float control object

minimum - the smallest value permitted for the control

maximum - the largest value permitted for the control

precision - the resolution or granularity of the control. This is the size of the increment between discrete valid values.

updatePeriod - the smallest time interval, in microseconds, over which the control can change from one discrete value to the next during a shift

initialValue - the value that the control starts with when constructed

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

Throws:

IllegalArgumentException - if {@code minimum} is greater than {@code maximum} or {@code initialValue} does not fall within the allowable range

 protected FloatControl(Type type,
    float minimum,
    float maximum,
    float precision,
    int updatePeriod,
    float initialValue,
    String units,
    String minLabel,
    String midLabel,
    String maxLabel) 
{
        super(type);
        if (minimum  > maximum) {
            throw new IllegalArgumentException("Minimum value " + minimum
                    + " exceeds maximum value " + maximum + ".");
        }
        if (initialValue <  minimum) {
            throw new IllegalArgumentException("Initial value " + initialValue
                    + " smaller than allowable minimum value " + minimum + ".");
        }
        if (initialValue  > maximum) {
            throw new IllegalArgumentException("Initial value " + initialValue
                    + " exceeds allowable maximum value " + maximum + ".");
        }
        this.minimum = minimum;
        this.maximum = maximum;
        this.precision = precision;
        this.updatePeriod = updatePeriod;
        this.value = initialValue;
        this.units = units;
        this.minLabel = ( (minLabel == null) ? "" : minLabel);
        this.midLabel = ( (midLabel == null) ? "" : midLabel);
        this.maxLabel = ( (maxLabel == null) ? "" : maxLabel);
}

Constructs a new float control object with the given parameters

Parameters:

type - the kind of control represented by this float control object

minimum - the smallest value permitted for the control

maximum - the largest value permitted for the control

precision - the resolution or granularity of the control. This is the size of the increment between discrete valid values.

updatePeriod - the smallest time interval, in microseconds, over which the control can change from one discrete value to the next during a shift

initialValue - the value that the control starts with when constructed

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

minLabel - the label for the minimum value, such as "Left" or "Off"

midLabel - the label for the midpoint value, such as "Center" or "Default"

maxLabel - the label for the maximum value, such as "Right" or "Full"

Throws:

IllegalArgumentException - if {@code minimum} is greater than {@code maximum} or {@code initialValue} does not fall within the allowable range

 public String getMaxLabel() 
{
        return maxLabel;
}

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

 public float getMaximum() 
{
        return maximum;
}

Obtains the maximum value permitted.

 public String getMidLabel() 
{
        return midLabel;
}

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

 public String getMinLabel() 
{
        return minLabel;
}

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

 public float getMinimum() 
{
        return minimum;
}

Obtains the minimum value permitted.

 public float getPrecision() 
{
        return precision;
}

Obtains the resolution or granularity of the control, in the units that the control measures. The precision is the size of the increment between discrete valid values for this control, over the set of supported floating-point values.

 public String getUnits() 
{
        return units;
}

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

 public int getUpdatePeriod() 
{
        return updatePeriod;
}

Obtains the smallest time interval, in microseconds, over which the control's value can change during a shift. The update period is the inverse of the frequency with which the control updates its value during a shift. If the implementation does not support value shifting over time, it should set the control's value to the final value immediately and return -1 from this method.

 public float getValue() 
{
        return value;
}

Obtains this control's current value.

 public  void setValue(float newValue) 
{
        if (newValue  > maximum) {
            throw new IllegalArgumentException("Requested value " + newValue + " exceeds allowable maximum value " + maximum + ".");
        }
        if (newValue <  minimum) {
            throw new IllegalArgumentException("Requested value " + newValue + " smaller than allowable minimum value " + minimum + ".");
        }
        value = newValue;
}

Sets the current value for the control. The default implementation simply sets the value as indicated. If the value indicated is greater than the maximum value, or smaller than the minimum value, an IllegalArgumentException is thrown. Some controls require that their line be open before they can be affected by setting a value.

 public  void shift(float from,
    float to,
    int microseconds) 
{
        // test "from" value, "to" value will be tested by setValue()
        if (from <  minimum) {
            throw new IllegalArgumentException("Requested value " + from
                    + " smaller than allowable minimum value " + minimum + ".");
        }
        if (from  > maximum) {
            throw new IllegalArgumentException("Requested value " + from
                    + " exceeds allowable maximum value " + maximum + ".");
        }
        setValue(to);
}

Changes the control value from the initial value to the final value linearly over the specified time period, specified in microseconds. This method returns without blocking; it does not wait for the shift to complete. An implementation should complete the operation within the time specified. The default implementation simply changes the value to the final value immediately.

 public String toString() 
{
        return new String(getType() + " with current value: " + getValue() + " " + units +
                          " (range: " + minimum + " - " + maximum + ")");
}

Provides a string representation of the control