Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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.
 
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

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

Compatibilidade dos navegadores

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support14 Yes25 No156
BiquadFilterNode() constructor551 ?53 No422 ?
detune141225 No156
frequency141225 No156
gain141225 No156
Q141225 No156
type141225 No156
getFrequencyResponse141225 No156
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support1418 Yes2615 ? Yes
BiquadFilterNode() constructor551551 ?53422 ?6.0
detune Yes18 Yes2615 ? Yes
frequency Yes18 Yes2615 ? Yes
gain Yes18 Yes2615 ? Yes
Q Yes18 Yes2615 ? Yes
type Yes18 Yes2615 ? Yes
getFrequencyResponse Yes18 Yes2615 ? Yes

1. Before Chrome 59, the default values were not supported.

2. Before Opera 46, the default values were not supported.

Veja também

Etiquetas do documento e colaboradores

Colaboradores desta página: Jonathanifpe
Última atualização por: Jonathanifpe,