MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

현재 번역은 완벽하지 않습니다. 한국어로 문서 번역에 동참해주세요.

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 Read only
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

The following example shows basic usage of an AudioContext to create a Biquad filter node. For a complete working example, check out our voice-change-o-matic demo (look at the source code too).

var audioCtx = new (window.AudioContext || window.webkitAudioContext)();

//set up the different audio nodes we will use for the app
var analyser = audioCtx.createAnalyser();
var distortion = audioCtx.createWaveShaper();
var gainNode = audioCtx.createGain();
var biquadFilter = audioCtx.createBiquadFilter();
var convolver = audioCtx.createConvolver();

// connect the nodes together

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyser);
analyser.connect(distortion);
distortion.connect(biquadFilter);
biquadFilter.connect(convolver);
convolver.connect(gainNode);
gainNode.connect(audioCtx.destination);

// Manipulate the Biquad filter

biquadFilter.type = "lowshelf";
biquadFilter.frequency.value = 1000;
biquadFilter.gain.value = 25;

Specifications

Specification Status Comment
Web Audio API
The definition of 'BiquadFilterNode' in that specification.
Working Draft  

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 50.0 (Yes) 25.0 (25.0)  No support 15webkit
22 (unprefixed)
6.0webkit
constructor 55.0 ? ? ? 42 ?
Feature Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support (Yes) (Yes) 26.0 1.2 ? (Yes) ? 50.0
constructor No support 55.0 ? ? ? ? 42 ? 55.0

See also

문서 태그 및 공헌자

 이 페이지의 공헌자: chant
 최종 변경: chant,