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 (en-US) `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 (en-US) `AudioParam` (en-US) representando a dessintonização da frequência em cents.

`BiquadFilterNode.Q` (en-US)

É um a-rate (en-US) `AudioParam` (en-US), um double representando um Q factor, ou *fator de qualidade*.

`BiquadFilterNode.gain` (en-US) Somente leitura 

É um a-rate (en-US) `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.

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

{{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 with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Utilizando a Web Audio API (en-US)