BiquadFilterNode

Construtor

BiquadFilterNode()

Cria uma nova instância de um objeto do tipo BiquadFilterNode.

Propriedades

Herda as propriedades de seu pai, AudioNode.

BiquadFilterNode.frequency

É um a-rate AudioParam, um double que representa a frequência no algoritmo de filtragem atual, medido em hertz (Hz).

BiquadFilterNode.detune

É um  a-rate AudioParam representando a dessintonização da frequência em cents.

BiquadFilterNode.Q

É um a-rate AudioParam, um double representando um Q factor, ou fator de qualidade.

BiquadFilterNode.gain Somente leitura

É um a-rate AudioParam, um double representando o gain utilizado no algoritmo de filtragem atual.

BiquadFilterNode.type

É um valor string que define o tipo de algoritmo de filtragem que o nó está implementando.
 

O significado dos diferentes parâmetros de acordo com o tipo de filtro (detune tem o mesmo significado, então não está listado abaixo)

tipo	Descrição	frequência	Q	ganho
lowpass	Filtro de resonância lowpass padrão de segunda ordem com 12dB/octave rolloff. Frequências abaixo do ponto de corte passam; frequências acima são atenuadas.	A frequência de corte.	Indica o quão perto a frequência chegou em relação ao ponto de corte. Quantomaior o valor, maior será a aproximação.	Não utilizado
highpass	Filtro de resonância highpass padrão de segunda ordem com 12dB/octave rolloff. Frequências abaixo do ponto de corte são atenuadas; frequências acima passam.	A frequência de corte.	Indica o quão perto a frequência chegou em relação ao ponto de corte. Quantomaior o valor, maior será a aproximação.	Não utilizado
bandpass	Filtro bandpass padrão de segunda ordem. Frequências fora do dado limite de frequências são atenuadas; frequências dentro do limite passam.	O centro de alcance de frequências.	Controla a largura da banda de frequência. Quanto maior o valor Q, menor a frequência de banda.	Não utilizado
lowshelf	Filtro lowshelf padrão de segunda ordem. Frequências menores que a frequência recebem um aumento, ou uma atenuação; frequências maiores não sofrem alterações.	O limite superior das frequênicas recebe um aumento ou atenuação.	Não utilizado	O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.
highshelf	Filtro highshelf padrão de segunda ordem. Frequências maiores que a frequência recebem aumento ou atenuação; frequências abaixo disso não sofrem alterações.	O limite inferior de frequências recebe aumento ou uma atenuação.	Não utilizado	O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.
peaking	Frequências dentro da faixa de frequencias  recebem aumento ou atenuação; frequências fora da faixa não sofrem alterações.	O meio da faixa de frequência recebe um aumento ou uma atenuação.	Controla a largura da banda de frequência. Quanto maior o valor Q, menor a frequência de banda.	O aumento, em dB, para ser aplicado; se negativo, ele será uma atenuação.
notch	Filtro notch padrão, também chamado de filtro band-stop ou band-rejection. É o oposto do filtro de de bandpass: frequências fora da faixa de frequências atribuída passam; frequências de dentro da faixa são atenuadas.	O centro de alcance de frequências.	Controla a largura da banda de frequência. Quanto maior o valor Q, menor a frequência de banda.	Não utilizado
allpass	Filtro allpass padrão de segunda ordem. Permite que todas as frequências passem, porém altera a relação de fase entre as diversas frequências.	A frequência com o máximo group delay, ou seja, a frequência onde o centro da fase de transição ocorre.	Controla o quão apurada a transição é na frequência média. Quanto maior este parâmetro, mais apurada e ampla será a transição	Não utilizado

Métodos

Herda os métodos de seu pai, AudioNode.

BiquadFilterNode.getFrequencyResponse()

A partir dos parâmetros de configuração do filtro atual, este método calcula a frequência de resposta para frequências especificadas no array de frequências.

Exemplo

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.setValueAtTime(1000, audioCtx.currentTime);
biquadFilter.gain.setValueAtTime(25, audioCtx.currentTime);

Especificações

Compatibilidade dos navegadores

Veja também

• Utilizando a Web Audio API