BaseAudioContext: Methode createIIRFilter()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

Die createIIRFilter() Methode des BaseAudioContext Schnittstellenobjekts erstellt einen IIRFilterNode, der einen allgemeinen Infinite Impulse Response (IIR)-Filter darstellt, der als verschiedene Arten von Filtern konfiguriert werden kann.

Hinweis: Der IIRFilterNode() Konstruktor ist der empfohlene Weg, um einen IIRFilterNode zu erstellen; siehe Creating an AudioNode.

Syntax

js
createIIRFilter(feedforward, feedback)

Parameter

feedforward

Ein Array von Gleitkommawerten, das die Feedforward- (Zähler) Koeffizienten für die Übertragungsfunktion des IIR-Filters angibt. Die maximale Länge dieses Arrays beträgt 20, und mindestens ein Wert muss ungleich null sein.

feedback

Ein Array von Gleitkommawerten, das die Feedback- (Nenner) Koeffizienten für die Übertragungsfunktion des IIR-Filters angibt. Dieses Array kann bis zu 20 Mitglieder haben, das erste darf nicht null sein.

Rückgabewert

Ein IIRFilterNode, der den Filter mit den angegebenen Feedback- und Feedforward-Koeffizientenarrays implementiert.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn alle feedforward Koeffizienten 0 sind oder wenn der erste feedback Koeffizient 0 ist.

NotSupportedError DOMException

Wird ausgelöst, wenn ein oder beide Eingabearrays mehr als 20 Mitglieder enthalten.

Spezifikationen

Specification
Web Audio API
# dom-baseaudiocontext-createiirfilter

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch