IIRFilterNode: IIRFilterNode() コンストラクター

IIRFilterNode()ウェブオーディオ API のコンストラクターで、一般的な無限インパルス応答フィルターを実装するための IIRFilterNode プロセッサーとなる新しい AudioNode オブジェクトを作成します。

構文

js
new IIRFilterNode(context, options)

引数

context

AudioContext への参照です。

options

オプションは次の通りです。

feedforward

フィードフォワードの係数の列です。

feedback

フィードバック係数の列です。

channelCount

ノードへの任意の入力にアップミキシングおよびダウンミキシング接続する際に、何チャンネルを用いるか決めるために用いられる整数を表します。(詳細はAudioNode.channelCountを参照してください。)その使い方と正確な定義は channelCountMode の値に依存します。

channelCountMode

ノードの入力と出力の間でチャンネルを一致させる方法を記述する列挙値を表します。(既定値を含む詳細情報は AudioNode.channelCountMode を参照してください。)

channelInterpretation

チャンネルの意味を説明する列挙値を表します。この解釈により、音声のアップミキシングおよびダウンミキシングがどう行われるかが定義されます。 使用可能な値は "speakers" または "discrete" です。(既定値を含む詳細な情報は AudioNode.channelCountMode を参照してください。)

ウェブオーディオ API の他のノードとは異なり、IIR フィルターの作成時に渡されるオプションは、オプションではありません。フィルターは作業するためにこの値を必要とし、利用できるフィルターの範囲が広いため、既定値はありません。

返値

新しい IIRFilterNode オブジェクトインスタンスです。

js
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,
});

仕様書

Specification
Web Audio API
# dom-iirfilternode-constructor-iirfilternode

ブラウザーの互換性

BCD tables only load in the browser