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
Desktop | Mobile | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Basic support | Chrome Full support 14 | Edge Full support Yes | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
BiquadFilterNode() constructor | Chrome
Full support
55
| Edge ? | Firefox Full support 53 | IE No support No | Opera
Full support
42
| Safari ? | WebView Android
Full support
55
| Chrome Android
Full support
55
| Edge Mobile ? | Firefox Android Full support 53 | Opera Android
Full support
42
| Safari iOS ? | Samsung Internet Android Full support 6.0 |
detune | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
frequency | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
gain | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
Q | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
type | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari iOS ? | Samsung Internet Android Full support Yes |
getFrequencyResponse | Chrome Full support 14 | Edge Full support 12 | Firefox Full support 25 | IE No support No | Opera Full support 15 | Safari Full support 6 | WebView Android Full support Yes | Chrome Android Full support 18 | Edge Mobile Full support Yes | Firefox Android Full support 26 | Opera Android Full support 15 | Safari 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.