Класс FloatControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.FloatControl

public abstract class FloatControl extends Control

Объект FloatControl обеспечивает управление диапазоном значений с плавающей запятой. Регуляторы с плавающей запятой часто представлены в графических пользовательских интерфейсах в виде объектов с непрерывной регулировкой, например ползунков или поворотных ручек. Конкретные подклассы FloatControl реализуют регуляторы, такие как усиление и панорамирование, которые определённым образом влияют на аудиосигнал линии и могут управляться приложением. Внутренний класс FloatControl.Type предоставляет статические экземпляры типов, используемых для идентификации некоторых распространённых видов регуляторов с плавающей запятой.

Абстрактный класс FloatControl предоставляет методы для задания и получения текущего значения регулятора с плавающей запятой. Другие методы позволяют получить возможный диапазон значений и разрешение регулятора (наименьший шаг между возвращаемыми значениями). Некоторые регуляторы с плавающей запятой позволяют плавно изменять значение до нового в течение заданного периода времени. FloatControl также включает методы, возвращающие строковые метки для минимального, максимального и среднего положений регулятора.

С версии:

1.3

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`FloatControl.Type`	Экземпляр внутреннего класса `FloatControl.Type` идентифицирует один из видов регуляторов с плавающей запятой.

Краткое описание конструкторов

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

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

Модификатор	Конструктор	Описание
`protected`	Создаёт новый объект регулятора с плавающей запятой с заданными параметрами.
`protected`	Создаёт новый объект регулятора с плавающей запятой с заданными параметрами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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()`	Возвращает строковое представление регулятора с плавающей запятой.

Методы, объявленные в классе Control

getType

Методы, объявленные в классе 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)

Создаёт новый объект регулятора с плавающей запятой с заданными параметрами.

Параметры:: type — вид регулятора, представленного этим объектом регулятора с плавающей запятой; minimum — наименьшее значение, допустимое для регулятора; maximum — наибольшее значение, допустимое для регулятора; precision — разрешение или шаг регулятора. Это величина шага между отдельными допустимыми значениями.; updatePeriod — наименьший временной интервал в микросекундах, за который регулятор может перейти от одного отдельного значения к следующему при вызове shift; initialValue — значение, устанавливаемое при создании регулятора; units — метка единиц измерения значений регулятора, например «дБ» или «кадров в секунду»; 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 — метка единиц измерения значений регулятора, например «дБ» или «кадров в секунду»
Вызывает исключение:: 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

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

Линейно изменяет значение регулятора от начального до конечного в течение заданного периода времени, указанного в микросекундах. Метод возвращает управление, не блокируя вызывающий поток; он не ожидает завершения сдвига. Реализация должна выполнить операцию в течение указанного времени. Реализация по умолчанию просто немедленно изменяет значение на конечное.

Параметры:

from — начальное значение в начале сдвига

to — конечное значение после сдвига

microseconds — максимальная продолжительность сдвига в микросекундах

Вызывает исключение:

IllegalArgumentException — если значение from или to не входит в допустимый диапазон

См. также:

toString

public String toString()

Возвращает строковое представление регулятора с плавающей запятой.

Переопределяет:: toString в классе Control
Возвращает:: строковое представление регулятора с плавающей запятой

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/FloatControl.html