Класс FloatControl

java.lang.Object

javax.sound.sampled.Control

javax.sound.sampled.FloatControl

public abstract class FloatControl extends Control

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

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

Since:

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

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

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

Параметры:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/sampled/FloatControl.html