BiquadFilterNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

The BiquadFilterNode interface represents a simple low-order filter, and is created using the AudioContext.createBiquadFilter() method. It is an AudioNode that can represent different kinds of filters, tone control devices, and graphic equalizers. A BiquadFilterNode always has exactly one input and one output.

Number of inputs 1
Number of outputs 1
Channel count mode "max"
Channel count 2 (not used in the default count mode)
Channel interpretation "speakers"

Constructor

BiquadFilterNode()

Creates a new instance of an BiquadFilterNode object.

Properties

Inherits properties from its parent, AudioNode.

BiquadFilterNode.frequency

Is an a-rate AudioParam, a double representing a frequency in the current filtering algorithm measured in hertz (Hz).

BiquadFilterNode.detune

Is an a-rate AudioParam representing detuning of the frequency in cents.

BiquadFilterNode.Q

Is an a-rate AudioParam, a double representing a Q factor, or quality factor.

BiquadFilterNode.gain 읽기 전용

Is an a-rate AudioParam, a double representing the gain used in the current filtering algorithm.

BiquadFilterNode.type

Is a string value defining the kind of filtering algorithm the node is implementing.

The meaning of the different parameters depending of the type of the filter (detune has the same meaning regardless, so isn't listed below)
type Description frequency Q gain
lowpass 12dB/octave의 롤오프를 가진 표준 2차 공진 로우패스 필터입니다. 컷오프 이하의 주파수는 통과하며 그 이상의 주파수는 감쇠합니다. 컷오프 주파수 컷오프 부근에서 주파수의 피크가 얼마나 큰지 나타냅니다. 값이 클수록 피크가 커집니다. Not used
highpass 12dB/octave의 롤오프를 가진 표준 2차 공진 하이패스 필터입니다. 컷오프 이하의 주파수는 감쇠하며 그 이상의 주파수는 통과합니다. 컷오프 주파수 컷오프 부근에서 주파수의 피크가 얼마나 큰지 나타냅니다. 값이 클수록 피크가 커집니다. Not used
bandpass 표준 2차 밴드패스 필터입니다. 주어진 주파수 대역 바깥의 주파수는 감쇠되며, 이내의 주파수는 통과합니다. 주파수 대역의 중앙 주파수 대역의 폭을 조정합니다. Q값이 클수록 주파수 대역은 작아집니다. Not used
lowshelf 표준 2차 로우쉘프 필터입니다. 기준 주파수보다 낮은 주파수는 증폭되거나 감쇠됩니다. 그 이상의 주파수는 변하지 않습니다. 증폭이나 감쇠를 얻는 주파수의 상한값 Not used 적용할 증폭(단위 : dB), 음수이면 감쇠됩니다.
highshelf 표준 2차 하이쉘프 필터입니다. 기준 주파수보다 큰 주파수는 증폭되거나 감쇠됩니다. 그 이하의 주파수는 변하지 않습니다. 증폭이나 감쇠를 얻는 주파수의 하한값 Not used 적용할 증폭(단위 : dB), 음수이면 감쇠됩니다.
peaking 대역 내의 주파수는 증폭되거나 감쇠됩니다. 바깥의 주파수는 변하지 않습니다. 증폭이나 감쇠를 얻는 주파수 대역의 중앙 주파수 대역의 폭을 조정합니다. Q값이 클수록 주파수 대역은 작아집니다. 적용할 증폭(단위 : dB), 음수이면 감쇠됩니다.
notch 밴드 스톱, 혹은 밴드 리젝션으로 불리는 표준 notch 필터입니다. 이는 밴드패스 필터와 반대입니다. 주어진 대역폭 바깥의 주파수는 통과하며, 안쪽의 주파수는 감쇠합니다. 주파수 대역의 중앙 주파수 대역의 폭을 조정합니다. Q값이 클수록 주파수 대역은 작아집니다. Not used
allpass 표준 2차 allpass 필터입니다. 이는 모든 주파수를 통과시키지만, 가변 주파수 사이의 위상 관계를 변화시킵니다. 최대 group delay를 갖는 주파수, 즉 위상 전이 발생의 중심에 있는 주파수입니다. 중간 주파수에서 전환이 얼마나 선명한가를 제어합니다. 이 매개 변수가 클수록 더 선명하고 크게 전환됩니다. Not used

Methods

AudioNode 로부터 메서드를 상속받습니다.

BiquadFilterNode.getFrequencyResponse()

이 메서드는 현재 필터 파라미터 설정으로부터 제공된 주파수 배열에 지정된 주파수에 대한 주파수 응답을 계산합니다

Example

See AudioContext.createBiquadFilter for example code that shows how to use an AudioContext to create a Biquad filter node.

명세서

Specification
Web Audio API
# BiquadFilterNode

브라우저 호환성

BCD tables only load in the browser

See also