JavaScript:Библиотеки/p5.sound/masterVolume()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.



masterVolume() [1]

Описание

Меняет громкость всего звука в текущем скетче.

Значения варьируются от «0.0» (тишина) до «1.0» (полна громкость). Поскольку «1.0» – это максимальная громкость цифрового звука, то значение выше «1.0» может вызвать цифровые искажения звука. Кроме того, в этом параметре можно задать осциллятор, меняющий громкость при помощи аудиосигнала. Параметр rampTime позволяет задать затухание. Если вам нужны более сложные затухания, используйте класс p5.Env.

Как это работает: Загружая модуль p5.sound, вы создаете один объект p5sound. Через него должны будут пройти все звуковые объекты в этом модуле перед тем, как выйти на главный источник вывода аудиоданных на вашем ПК. Таким образом, если вы измените громкость p5sound, это повлияет на громкость всего звука в этом модуле.

Если параметра не задано, возвращает объект GainNode из Web Audio API.

Чтобы использовать эту функцию, нужно подключить библиотеку p5.sound. Для этого в заголовок своего файла «index.html» впишите следующее:

<script language="javascript" type="text/javascript" src="path/to/p5.sound.js"></script>

Синтаксис

masterVolume(volume, [rampTime], [timeFromNow])

Параметры

volume       громкость в диапазоне между «0.0» и «1.0» или осциллятор. Тип данных  number, объект
rampTime     время затухания (в секундах). Тип данных  number
timeFromNow  время, спустя которое должно запуститься заданное событие. Тип данных  number

Возвращаемое значение

Пример

№1

№2

№3

См.также

Внешние ссылки