IIRFilterNode: IIRFilterNode() コンストラクター
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2021年4月.
IIRFilterNode() はウェブオーディオ API のコンストラクターで、一般的な無限インパルス応答フィルターを実装するための IIRFilterNode プロセッサーとなる新しい AudioNode オブジェクトを作成します。
構文
new IIRFilterNode(context, options)
引数
context-
AudioContextへの参照です。 options-
オプションは次の通りです。
feedforward-
フィードフォワードの係数の列です。
feedback-
フィードバック係数の列です。
channelCount-
ノードへの任意の入力にアップミキシングおよびダウンミキシング接続する際に、何チャンネルを用いるか決めるために用いられる整数を表します。（詳細は
AudioNode.channelCountを参照してください。）その使い方と正確な定義はchannelCountModeの値に依存します。 channelCountMode-
ノードの入力と出力の間でチャンネルを一致させる方法を記述する列挙値を表します。（既定値を含む詳細情報は
AudioNode.channelCountModeを参照してください。） channelInterpretation-
チャンネルの意味を説明する列挙値を表します。この解釈により、音声のアップミキシングおよびダウンミキシングがどう行われるかが定義されます。 使用可能な値は
"speakers"または"discrete"です。（既定値を含む詳細な情報はAudioNode.channelCountModeを参照してください。）
ウェブオーディオ API の他のノードとは異なり、IIR フィルターの作成時に渡されるオプションは、オプションではありません。フィルターは作業するためにこの値を必要とし、利用できるフィルターの範囲が広いため、既定値はありません。
返値
新しい IIRFilterNode オブジェクトインスタンスです。
例
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-iirfilternode |
ブラウザーの互換性
Enable JavaScript to view this browser compatibility table.