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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 14Edge Full support YesFirefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
BiquadFilterNode() constructorChrome Full support 55
Notes
Full support 55
Notes
Notes Before Chrome 59, the default values were not supported.
Edge ? Firefox Full support 53IE No support NoOpera Full support 42
Notes
Full support 42
Notes
Notes Before Opera 46, the default values were not supported.
Safari ? WebView Android Full support 55
Notes
Full support 55
Notes
Notes Before version 59, the default values were not supported.
Chrome Android Full support 55
Notes
Full support 55
Notes
Notes Before Chrome 59, the default values were not supported.
Edge Mobile ? Firefox Android Full support 53Opera Android Full support 42
Notes
Full support 42
Notes
Notes Before Opera 46, the default values were not supported.
Safari iOS ? Samsung Internet Android Full support 6.0
detuneChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
frequencyChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
gainChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
QChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
typeChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes
getFrequencyResponseChrome Full support 14Edge Full support 12Firefox Full support 25IE No support NoOpera Full support 15Safari Full support 6WebView Android Full support YesChrome Android Full support 18Edge Mobile Full support YesFirefox Android Full support 26Opera Android Full support 15Safari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Veja também

Etiquetas do documento e colaboradores

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