BiquadFilterNode
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.
Das BiquadFilterNode
-Interface stellt einen einfachen Filter niedriger Ordnung dar und wird mit der Methode BaseAudioContext/createBiquadFilter
erstellt. Es ist ein AudioNode
, das verschiedene Arten von Filtern, Klangregelgeräten und grafischen Equalizern darstellen kann. Ein BiquadFilterNode
hat immer genau einen Eingang und einen Ausgang.
Anzahl der Eingänge | 1 |
---|---|
Anzahl der Ausgänge | 1 |
Kanalanzahl-Modus | "max" |
Kanalanzahl | 2 (nicht im Standardanzahl-Modus verwendet) |
Kanalinterpretation | "speakers" |
Konstruktor
BiquadFilterNode()
-
Erstellt eine neue Instanz eines
BiquadFilterNode
-Objekts.
Instanz-Eigenschaften
Übernimmt Eigenschaften von seinem Elternteil, AudioNode
.
Hinweis:
Obwohl die zurückgegebenen AudioParam
-Objekte schreibgeschützt sind, sind die Werte, die sie repräsentieren, nicht.
BiquadFilterNode.frequency
Schreibgeschützt-
Ein a-rate
AudioParam
, ein Doppelwert, der eine Frequenz im aktuellen Filteralgorithmus in Hertz (Hz) darstellt. BiquadFilterNode.detune
Schreibgeschützt-
Ein a-rate
AudioParam
, das die Verstimmung der Frequenz in Cent darstellt. BiquadFilterNode.Q
Schreibgeschützt-
Ein a-rate
AudioParam
, ein Doppelwert, der einen Q-Faktor, oder Qualitätsfaktor, darstellt. BiquadFilterNode.gain
Schreibgeschützt-
Ein a-rate
AudioParam
, ein Doppelwert, der die im aktuellen Filteralgorithmus verwendete Verstärkung darstellt. BiquadFilterNode.type
-
Ein Zeichenfolgenwert, der die Art des vom Knoten implementierten Filteralgorithmus definiert.
Die Bedeutung der verschiedenen Parameter je nach Art des Filters (Detune hat unabhängig davon, die gleiche Bedeutung, daher unten nicht aufgeführt) type
Beschreibung frequency
Q
gain
lowpass
Standardmäßiger Resonanz-Tiefpassfilter zweiter Ordnung mit 12dB/Oktave Abfall. Frequenzen unterhalb der Grenzfrequenz passieren; Frequenzen darüber werden abgeschwächt. Die Grenzfrequenz. Gibt an, wie stark die Frequenz um die Grenzfrequenz ausgeprägt ist. Je größer der Wert, desto größer ist der Spitzenwert. Nicht verwendet highpass
Standardmäßiger Resonanz-Hochpassfilter zweiter Ordnung mit 12dB/Oktave Abfall. Frequenzen unterhalb der Grenzfrequenz werden abgeschwächt; Frequenzen darüber passieren. Die Grenzfrequenz. Gibt an, wie stark die Frequenz um die Grenzfrequenz ausgeprägt ist. Je größer der Wert, desto größer ist der Spitzenwert. Nicht verwendet bandpass
Standardmäßiger Bandpassfilter zweiter Ordnung. Frequenzen außerhalb des angegebenen Bereichs werden abgeschwächt; die Frequenzen innerhalb davon passieren. Die Mitte des Frequenzbereichs. Steuert die Breite des Frequenzbandes. Je größer der Q
-Wert, desto kleiner das Frequenzband.Nicht verwendet lowshelf
Standardmäßiger Lowshelf-Filter zweiter Ordnung. Frequenzen unterhalb der Frequenz erhalten eine Verstärkung oder eine Abschwächung; Frequenzen darüber bleiben unverändert. Die obere Grenze der Frequenzen, die eine Verstärkung oder Abschwächung erhalten. Nicht verwendet Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein. highshelf
Standardmäßiger Highshelf-Filter zweiter Ordnung. Frequenzen oberhalb der Frequenz erhalten eine Verstärkung oder Abschwächung; Frequenzen darunter bleiben unverändert. Die untere Grenze der Frequenzen, die eine Verstärkung oder Abschwächung erhalten. Nicht verwendet Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein. peaking
Frequenzen innerhalb des Bereichs erhalten eine Verstärkung oder Abschwächung; Frequenzen außerhalb davon bleiben unverändert. Die Mitte des Frequenzbereichs, der eine Verstärkung oder Abschwächung erhält. Steuert die Breite des Frequenzbandes. Je größer der Q
-Wert, desto kleiner das Frequenzband.Die Verstärkung in dB, die angewendet werden soll; wenn negativ, wird es eine Abschwächung sein. notch
Standardmäßiger Notch- Filter, auch als Band-Stop- oder Band-Rejection-Filter bezeichnet. Es ist das Gegenteil eines Bandpass-Filters: Frequenzen außerhalb des angegebenen Frequenzbereichs passieren; Frequenzen innerhalb davon werden abgeschwächt. Die Mitte des Frequenzbereichs. Steuert die Breite des Frequenzbandes. Je größer der Q
-Wert, desto kleiner das Frequenzband.Nicht verwendet allpass
Standardmäßiger Allpass- Filter zweiter Ordnung. Er lässt alle Frequenzen durch, verändert jedoch die Phasenbeziehung zwischen den verschiedenen Frequenzen. Die Frequenz mit der maximalen Gruppenlaufzeit, das heißt die Frequenz, bei der das Zentrum der Phasenverschiebung auftritt. Steuert, wie scharf der Übergang bei der mittleren Frequenz ist. Je größer dieser Parameter ist, desto schärfer und größer wird der Übergang sein. Nicht verwendet
Instanz-Methoden
Übernimmt Methoden von seinem Elternteil, AudioNode
.
BiquadFilterNode.getFrequencyResponse()
-
Diese Methode berechnet aus den aktuellen Filterparameter-Einstellungen die Frequenzantwort für die in dem bereitgestellten Frequenzarray angegebenen Frequenzen.
Beispiel
Sehen Sie sich AudioContext.createBiquadFilter
für Beispielcode an, der zeigt, wie man einen AudioContext
verwendet, um einen Biquad-Filterknoten zu erstellen.
Spezifikationen
Specification |
---|
Web Audio API # BiquadFilterNode |
Browser-Kompatibilität
BCD tables only load in the browser