BiquadFilterNode.frequency

La propriété frequency de l'interface BiquadFilterNode est un  AudioParam de type k-rate : un nombre flottant à double précision représentant une fréquence de l'algorithme de filtrage courant, exprimée en hertz (Hz).

Sa valeur par défaut est de 350 avec une portée nominale de 10 à la fréquence de Nyquist, qui est la moitié de la fréquence d'échantillonnage.

Syntax

var contexteAudio = new AudioContext();
var filtreBiquad = contexteAudio.createBiquadFilter();
filtreBiquad.frequency.value = 3000;

Note: Bien que le AudioParam renvoyé soit en lecture seule, la valeur qu'il représente ne l'est pas.

Valeur

Un AudioParam.

Exemple

L'exemple suivant montre l'utilisation basique d'un AudioContext pour créer un filtre Biquad. Pour un exemple complet, consultez notre démo voice-change-o-matic (et son code source).

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

// mise en place des différents noeuds audio que nous utiliserons par la suite
var analyseur = contexteAudio.createAnalyser();
var distortion = contexteAudio.createWaveShaper();
var noeudGain = contexteAudio.createGain();
var filtreBiquad = contexteAudio.createBiquadFilter();
var convolution = contexteAudio.createConvolver();

// connecte les noeuds ensemble

source = audioCtx.createMediaStreamSource(stream);
source.connect(analyseur);
analyseur.connect(distortion);
distortion.connect(filtreBiquad);
biquadFilter.connect(convolution);
convolution.connect(noeudGain);
noeudGain.connect(contexteAudio.destination);

// manipule le filtre Biquad 

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

Spécification

Specification Status Comment
Web Audio API
La définition de 'frequency' dans cette spécification.
Version de travail  

Compatibilité navigateurs

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 10.0webkit 25.0 (25.0)  Pas de support 15.0webkit
22 (unprefixed)
6.0webkit
Feature Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? 26.0 1.2 ? ? ? 33.0

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : marie-ototoi
 Dernière mise à jour par : marie-ototoi,