getSoundFFTData

Devolve o espectro de frequências do som naquele instante.

Sintaxe

table getSoundFFTData ( element oSom, number tamanho [, number bandas = 0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oSom	element	—	Som a analisar, ou um jogador para analisar a voz dele.
tamanho	number	—	Tamanho da amostra. Precisa ser 256, 512, 1024, 2048, 4096, 8192 ou 16384.
bandas	number	0	Se maior que 0, agrupa o resultado nessa quantidade de bandas, guardando o pico de cada uma. Não pode ser negativo nem maior que tamanho / 2.

Retorno

Uma tabela indexada a partir de 0, ou false se o tamanho ou a quantidade de bandas for inválido ou se o argumento não for um som. Sem agrupamento a tabela tem tamanho / 2 + 1 valores; com agrupamento tem bandas valores.

Exemplo

-- oito barras de espectro, atualizadas a cada frame
local barras = getSoundFFTData(musica, 1024, 8)
if barras then
    outputDebugString(("grave: %.3f"):format(barras[0]))
end

Veja também

• getSoundWaveData — Devolve uma janela da forma de onda do som naquele instante.
• getSoundLevelData — Devolve o nível atual de cada canal.
• getSoundBPM — Devolve as batidas por minuto de um som.
• getSoundMetaTags — Lê as tags de um arquivo ou de um stream.