BiquadFilterNode: BiquadFilterNode() конструктор

Конструктор BiquadFilterNode() интерфейса Web Audio API создаёт новый объект BiquadFilterNode, представляющий собой простой фильтр низкого порядка.

context

Ссылка на контекст AudioContext.

options Необязательно

Объект со следующими свойствами:

type

Одна из следующих строк. Значение других параметров зависит от значения type.

lowpass

По умолчанию. Пропускает частоты ниже частоты среза и ослабляет частоты выше частоты среза. Это стандартный резонансный фильтр нижних частот второго порядка с крутизной спада 12 дБ/октава. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: определяет, насколько пиковым будет отклик на частоте среза. Большое значение делает отклик более пиковым. Обратите внимание, что для этого типа фильтра это значение не является традиционной добротностью, а является значением резонанса в децибелах.
• frequency: частота среза.
• gain: не используется.

highpass

Фильтр верхних частот является противоположностью фильтру нижних частот. Частоты выше частоты среза пропускаются, а частоты ниже частоты среза ослабляются. Реализует стандартный резонансный фильтр верхних частот второго порядка с крутизной спада 12 дБ/октава. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: определяет, насколько пиковым будет отклик на частоте среза. Большое значение делает отклик более пиковым. Обратите внимание, что для этого типа фильтра это значение не является традиционной добротностью, а является значением резонанса в децибелах.
• frequency: частота среза.
• gain: не используется.

bandpass

Фильтр полосовых частот пропускает определённый диапазон частот и ослабляет частоты ниже и выше этого диапазона. Реализует полосовой фильтр второго порядка. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: определяет ширину полосы пропускания. Ширина полосы сужается с увеличением добротности.
• frequency: центральная частота диапазона частот.
• gain: не используется.

lowshelf

Фильтр нижних полос пропускает все частоты, но добавляет усиление (или ослабление) низким частотам. Реализует фильтр нижних полос пропускания второго порядка. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: не используется.
• frequency: верхний предел частот, к которым применяется усиление или ослабление.
• gain: усиление, в дБ, которое нужно применить. Если значение отрицательное, частоты ослабляются.

highshelf

Фильтр верхних полос пропускания — противоположность фильтру нижних полос пропускания. Пропускает все частоты, но добавляет усиление высоким частотам. Реализует фильтр верхних полос пропускания второго порядка. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: не используется.
• frequency: нижний предел частот, к которым применяется усиление или ослабление.
• gain: усиление, в дБ, которое нужно применить. Если значение отрицательное, частоты ослабляются.

peaking

Фильтр пикового усиления пропускает все частоты, добавляя усиление или ослабление в определённом диапазоне частот. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: ширина полосы частот, которая усиливается. Большое значение означает узкую полосу.
• frequency: центральная частота диапазона усиления.
• gain: усиление, в дБ, которое нужно применить. Если значение отрицательное, частоты ослабляются.

notch

Фильтр среза (также известный как полосовой фильтр, или фильтр подавления полосы частот) — противоположность фильтру полосовых частот. Пропускает все частоты, кроме заданного диапазона. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: ширина полосы частот, которая ослабляется. Большое значение означает узкую полосу.
• frequency: центральная частота диапазона ослабления.
• gain: не используется.

allpass

Фильтр всех полос пропускания пропускает все частоты, но изменяет фазовую взаимосвязь между различными частотами. Реализует фильтр всех полос пропускания второго порядка. Для этого типа фильтра другие параметры имеют следующие значения:

• Q: резкость фазового перехода на центральной частоте. Большее значение означает более резкий переход и большую задержку группового времени.
• frequency: частота, где происходит центр фазового перехода. С другой стороны, это частота с максимальной задержкой группового времени.
• gain: не используется.

Q

По умолчанию 1. Значение этого параметра зависит от значения type.

detune

По умолчанию 0.

frequency

По умолчанию 350.

gain

По умолчанию 0. Значение этого параметра зависит от значения type.

channelCount

Целое число, используемое для определения количества каналов при смешивании и разделении каналов подключения к любым входам узла. (См. AudioNode.channelCount для получения дополнительной информации.) Его использование и точное определение зависят от значения channelCountMode.

channelCountMode

Представляет перечисляемое значение, описывающее способ соответствия каналов между входами и выходами узла. (См. AudioNode.channelCountMode для получения дополнительной информации, включая значения по умолчанию.)

channelInterpretation

Представляет перечисляемое значение, описывающее значение каналов. Это толкование определит, как будет происходить смешивание и разделение каналов аудио. Возможные значения — "speakers" или "discrete". (См. AudioNode.channelCountMode для получения дополнительной информации, включая значения по умолчанию.)

Новый экземпляр объекта BiquadFilterNode.