BiquadFilterNode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

A interface BiquadFilterNode representa um filtro simples de ordem baixa, e é criada utilizando o método AudioContext.createBiquadFilter() . É 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()

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.

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

{{page("/pt-BR/docs/Web/API/AudioContext.createBiquadFilter","Example")}}

Especificações

Specification
Web Audio API
# BiquadFilterNode

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também