JavaScript:Библиотеки/p5.sound/Класс p5.FFT/getEnergy()
getEnergy() [1]
Описание
Возвращает количество энергии, соответствующей заданной частоте, или среднее количество энергии между двумя заданными частотами. Эти частоты можно задать с помощью значений типа number (в Гц) или при помощи заранее заданных значений типа String («bass», «lowMid», «mid», «highMid» и «treble»). Возвращаемое значение будет в диапазоне между «0» (это будет значить, что на этой частоте нет энергии) и «255» (это значит, что у этой частоты максимальная энергия).
Примечание: до getEnergy() необходимо вызвать функцию analyze(). Она говорит объекту p5.FFT проанализировать частотные данные, после чего getEnergy() использует результаты, чтобы определить значение на заданной частоте или среднее значение для двух заданных частот.
Чтобы использовать эту функцию, нужно подключить библиотеку p5.sound. Для этого в заголовок своего файла «index.html» впишите следующее:
<script language="javascript" type="text/javascript" src="path/to/p5.sound.js"></script>
Синтаксис
getEnergy(frequency1, [frequency2])
Параметры
frequency1 – частота, для которой нужно вернуть значение энергии. Также можно задать здесь частотный диапазон при помощи заранее заданных значений «bass», «lowMid», «mid», «highMid» и «treble», и тогда getEnergy() вернет среднее значение для заданного частотного диапазона. Тип данных – number, String
frequency2 – если задать еще и этот параметр, getEnergy() вернет среднее количество энергии между частотами, заданными этом параметре и параметре «frequency2». Тип данных – number
Возвращаемое значение
Количество энергии в диапазоне от «0» до «255». Тип данных – number.
