Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

BiquadFilterNode

L'interface BiquadFilterNode représente un simple filtre de bas niveau, créé avec la méthode AudioContext.createBiquadFilter(). Il s'agit d'un AudioNode qui peut représenter différents types de filtres, dispositifs de réglage de tonalité ou égaliseurs graphiques. Un BiquadFilterNode a 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"

Propriétés

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

BiquadFilterNode.frequency
Est un AudioParam de type a-rate : un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage, exprimée en Hertz.
BiquadFilterNode.detune
Est un AudioParam de type a-rate : un nombre flottant à double précision représentant le désaccordage de la fréquence exprimé en cents.
BiquadFilterNode.Q
Est un AudioParam de type a-rate : un nombre flottant à double précision représentant un facteur Q, ou facteur de qualité.
BiquadFilterNode.gain Lecture seule
Est un AudioParam de type a-rate : un nombre flottant à double précision représentant le gain utilisé dans l'algorithme de filtrage.
BiquadFilterNode.type
Une chaîne définissant le type d'algorithme de filtrage que le noeud 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érieurs 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érieurs 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 un attenuation 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()
A 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

The following example shows basic usage of an AudioContext to create a Biquad filter node. For a complete working example, check out our voice-change-o-matic demo (look at the source code too).

var audioCtx = new (window.AudioContext || window.webkitAudioContext)();

//set up the different audio nodes we will use for the app
var analyser = audioCtx.createAnalyser();
var distortion = audioCtx.createWaveShaper();
var gainNode = audioCtx.createGain();
var biquadFilter = audioCtx.createBiquadFilter();
var convolver = audioCtx.createConvolver();

// connect the nodes together

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyser);
analyser.connect(distortion);
distortion.connect(biquadFilter);
biquadFilter.connect(convolver);
convolver.connect(gainNode);
gainNode.connect(audioCtx.destination);

// Manipulate the Biquad filter

biquadFilter.type = "lowshelf";
biquadFilter.frequency.value = 1000;
biquadFilter.gain.value = 25;

Spécification

Spécification Statut Commentaire
Web Audio API
La définition de 'BiquadFilterNode' dans cette spécification.
Version de travail  

Compatibilité navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique 50 25.0 (25.0)  Pas de support 15.0webkit
22 (unprefixed)
6.0webkit
Fonctionnalité Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Androïd
Support basique ? 26.0 1.2 ? ? ? 50

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : marie-ototoi, teoli, ouhouhsami, fscholz, tregagnon, Jeremie, dexterneo
 Dernière mise à jour par : marie-ototoi,