BaseAudioContext: createIIRFilter() メソッド

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月.

createIIRFilter() はBaseAudioContext インターフェイスのメソッドで、IIRFilterNode を生成します。これは一般的な**無限インパルス応答** (IIR) フィルターを生成し、これはよって様々な種類のフィルターとして提供できるように構成することができます。

メモ:IIRFilterNode() コンストラクターはIIRFilterNode を作成するための推奨される方法です。AudioNode の作成を参照してください。

構文

createIIRFilter(feedforward, feedback)

引数

feedforward: 浮動小数点値の配列で、 IIR フィルターの伝達関数のフィードフォワード（分子）係数を指定します。この配列の最大長は 20 で、少なくとも 1 つの値はゼロ以外でなければなりません。
feedback: 浮動小数点値の配列で、 IIR フィルターの伝達関数のフィードバック（分母）係数を指定します。この配列は最大 20 個のメンバーを持つことができ、そのうちの最初のメンバーは 0 以外でなければなりません。

返値

指定されたフィードバックとフィードフォワードの係数配列を持つフィルターを実装したIIRFilterNode です。

例外

InvalidStateErrorDOMException: すべてのfeedforward 係数が 0 の場合、あるいは最初のfeedback 係数が 0 の場合に発生します。
NotSupportedErrorDOMException: 入力配列の一方または両方が20個を超えた場合に発生します。