BiquadFilterNode

A interface BiquadFilterNode representa um filtro simples de ordem baixa, e é criada utilizando o método AudioContext.createBiquadFilter() (en-US) . É o AudioNode que pode representar diferentes tipos de filtros, dispositivo de controle de timbre, e equalizadores gráficos. Um BiquadFilterNode sempre tem exatamente uma entrada e uma saída.

Número de entradas 1
Número de saídas 1
Modo de contagem de canal "max"
Contagem de canal 2 (não utilizado no modo de contagem padrão)
Interpretação de canal "speakers"

Construtor

BiquadFilterNode() (en-US)
Cria uma nova instância de um objeto do tipo BiquadFilterNode.

Propriedades

Herda as propriedades de seu pai, AudioNode.

BiquadFilterNode.frequency (en-US)
É um a-rate AudioParam (en-US), um double que representa a frequência no algoritmo de filtragem atual, medido em hertz (Hz).
BiquadFilterNode.detune (en-US)
É um  a-rate AudioParam (en-US) representando a dessintonização da frequência em cents.
BiquadFilterNode.Q (en-US)
É um a-rate AudioParam (en-US), um double representando um Q factor, ou fator de qualidade.
BiquadFilterNode.gain (en-US) Somente leitura
É um a-rate AudioParam (en-US), um double representando o gain utilizado no algoritmo de filtragem atual.
BiquadFilterNode.type (en-US)
É 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() (en-US)
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

Especificação Status Comentário
Web Audio API
The definition of 'BiquadFilterNode' in that specification.
Rascunho atual  

Compatibilidade dos navegadores

BCD tables only load in the browser

Veja também