IIRFilterNode: IIRFilterNode() コンストラクター
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。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,
});
仕様書
| 仕様書 |
|---|
| Web Audio API> # dom-iirfilternode-iirfilternode> |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。