BiquadFilterNode
================

L'interface **`BiquadFilterNode`** représente un simple filtre de bas niveau, créé avec la méthode `AudioContext.createBiquadFilter()` (en-US). 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.

EventTarget

AudioNode

BiquadFilterNode

|  |  |
| --- | --- |
| 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()` (en-US)

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` (en-US)

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` (en-US)

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

`BiquadFilterNode.gain` (en-US) 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` (en-US)

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()` (en-US)

À 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 with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Utiliser l'API *Web Audio*