JavaScript:Библиотеки/p5.sound/Класс p5.SoundFile/setVolume()

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

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


Черновик


setVolume() [1]

Описание

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

Кроме того, в первом параметре можно указать осциллятор, управляющий громкостью с помощью аудиосигнала.

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

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

Синтаксис

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

Параметры

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

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

Пример

№1

№2

№3

См.также

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