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.

L'interface BiquadFilterNode représente un simple filtre de bas niveau, créé avec la méthode AudioContext.createBiquadFilter(). Il s'agit d'un objet AudioNode qui peut représenter différents types de filtres, dispositifs de réglage de tonalité ou égaliseurs graphiques. Un objet BiquadFilterNode possède toujours exactement une entrée et une sortie.

Nombre d'entrées	`1`
Nombre de sorties	`1`
Mode de comptage des canaux	`"max"`
Nombre de canaux	`2` (pas utilisés dans le mode de comptage par défaut)
Interprétation du canal	`"speakers"`

Constructeur

BiquadFilterNode(): Crée une nouvelle instance d'un objet BiquadFilterNode.

Propriétés

Hérite des propriétés de son parent, AudioNode.

BiquadFilterNode.frequency

Un objet AudioParam de type a-rate : c'est un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage, exprimée en Hertz.

BiquadFilterNode.detune

Un objet AudioParam de type a-rate : c'est un nombre flottant à double précision représentant le désaccordage de la fréquence exprimée en cents.

BiquadFilterNode.Q

Un objet AudioParam de type a-rate : c'est un nombre flottant à double précision représentant un facteur de qualité.

BiquadFilterNode.gain Lecture seule

Un objet AudioParam de type a-rate : c'est un nombre flottant à double précision représentant le gain utilisé dans l'algorithme de filtrage.

BiquadFilterNode.type

Une chaîne de caractères définissant le type d'algorithme de filtrage que le nœud implémente.

La signification des paramètres diffère en fonction du type du filtre (sauf `detune` qui a la même signification dans tous les cas, et n'est donc pas listé ci-dessous)
`type`	Description	`frequency`	`Q`	`gain`
`lowpass`	Filtre standard passe-bas résonnant de second ordre avec atténuation de 12dB/octave. Les fréquences inférieures au seuil sont inchangées ; les fréquences supérieures sont atténuées.	La fréquence de coupure	Indique comment la fréquence a culminé autour de la coupure. Plus la valeur est élevée, plus le point culminant est haut.	Non utilisé
`highpass`	Filtre standard passe-haut résonnant de second ordre avec atténuation de 12dB/octave. Les fréquences inférieures à la fréquence de coupure sont atténuées, les fréquences supérieures sont inchangées.	La fréquence de coupure	Indique comment la fréquence a culminé autour de la coupure. Plus la valeur est élevée, plus le point culminant est haut.	Non utilisé
`bandpass`	Filtre standard passe-bande de second ordre. Les fréquences en dehors de la plage donnée de fréquences sont atténués, et les fréquences à l'intérieur sont inchangées.	Le centre de la gamme de fréquences.	Contrôle la largeur de la bande de fréquences. Plus Q est grande, plus la bande de fréquences est grande.	Non utilisé
`lowshelf`	Filtre standard de dégradé de basses fréquences de second ordre. Les fréquences inférieures à la fréquence obtiennent une impulsion ou une atténuation ; les fréquences supérieures sont inchangées.	La limite supérieure des fréquences obtenant une impulsion ou une atténuation.	Non utilisé	L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
`highshelf`	Filtre standard de dégradé de hautes fréquences de second ordre. Les fréquences supérieures à la fréquence obtiennent une impulsion, ou une atténuation ; les fréquences inférieures restent inchangées.	La limite inférieure des fréquences obtenant une impulsion ou une atténuation.	Non utilisé	L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
`peaking`	Les fréquences à l'intérieur de la gamme obtiennent une impulsion ou une atténuation ; les fréquences en dehors de celle-ci sont inchangées.	Le milieu de la gamme de fréquences obtiennent une impulsion, ou une atténuation.	Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus grande est la bande de fréquences.	L'impulsion, en dB, à appliquer ; s'il est négatif, ce sera une atténuation.
`notch`	Filtre coupe standard, appelé aussi coupe-bande. C'est l'inverse d'un filtre passe-bande : les fréquences en dehors de la gamme de fréquences donnée sont inchangées ; les fréquences à l'intérieur de celle-ci sont atténuées.	Le centre de la gamme de fréquences.	Contrôle la largeur de la bande de fréquences. Plus grande est Q, plus grande est la bande de fréquences.	Non utilisé
`allpass`	Filtre standard passe-tout du second ordre. Laisse toutes les fréquences inchangées, mais modifie le rapport de phase entre les différentes fréquences.	La fréquence du retard de groupe maximal, qui est la fréquence à laquelle le centre de la transition de phase se produit.	Contrôle finement la transition à la fréquence moyenne. Plus ce paramètre est grand, plus la transition est fine et large.	Non utilisé

Méthodes

Hérite des propriétés de son parent, AudioNode.

BiquadFilterNode.getFrequencyResponse(): À partir des valeurs courantes des paramètres de filtre, calcule la fréquence de réponse pour des fréquences spécifiées dans le tableau de fréquences frequencyHz passé en paramètre.

Exemples

Voir la page AudioContext.createBiquadFilter pour un exemple de code illustrant comment utiliser un objet AudioContext afin de créer un nœud de filtre.

Spécifications

Specification
Web Audio API # BiquadFilterNode

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

Utiliser l'API Web Audio