IIRFilterNode()
The IIRFilterNode()
constructor of the Web Audio API creates a new IIRFilterNode
object which an AudioNode
processor which implements a general infinite impulse response filter.
Syntax
var iIRFilterNode = new IIRFilterNode(context, options)
Parameters
- context
-
A reference to an
AudioContext
. - options
-
Options are as follows:
-
feedforward
: A sequence of feedforward coefficients. -
feedback
: A sequence of feedback coefficients. -
channelCount
: Represents an integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node. (SeeAudioNode.channelCount
for more information.) Its usage and precise definition depend on the value ofchannelCountMode
. -
channelCountMode
: Represents an enumerated value describing the way channels must be matched between the node's inputs and outputs. (SeeAudioNode.channelCountMode
for more information including default values.) -
channelInterpretation
: Represents an enumerated value describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen. The possible values are"speakers"
or"discrete"
. (SeeAudioNode.channelCountMode
for more information including default values.)
-
Unlike other nodes in the Web Audio API, the options passed into the IIR filter upon creation are not optional. The filter needs these values to work and with the vast range of filters available, there is no default.
Return value
A new IIRFilterNode
object instance.
Examples
let feedForward = [0.00020298, 0.0004059599, 0.00020298]; let feedBackward = [1.0126964558, -1.9991880801, 0.9873035442]; const AudioContext = window.AudioContext || window.webkitAudioContext; const audioCtx = new AudioContext(); const iirFilter = new IIRFilterNode(audioCtx, { feedforward: feedForward, feedback: feedBackward });
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
IIRFilterNode |
55
Before version 59, the default values were not supported.
|
79 |
53 |
No |
42 |
14.1 |
55
Before version 59, the default values were not supported.
|
55
Before version 59, the default values were not supported.
|
53 |
42 |
14.5 |
6.0
Before Samsung Internet 7.0, the default values were not supported.
|
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IIRFilterNode/IIRFilterNode