Класс 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

See Also:

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

Модификатор и тип	Класс	Описание
`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, 2023, 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/21/docs/api/java.desktop/javax/sound/sampled/FloatControl.html