IIRFilterNode: IIRFilterNode() コンストラクター
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-constructor-iirfilternode |
ブラウザーの互換性
BCD tables only load in the browser