PT-BR/getSoundFFTData - Revision history

LordHenry at 20:07, 1 April 2023

2023-04-01T20:07:34Z

← Older revision		Revision as of 20:07, 1 April 2023
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{BR/~~Funcao cliente~~}}		{{PT-BR/Client_function}}

	Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma [[table\|tabela]] representando o quadro atual do áudio. Essa função permite a visualização do áudio.		Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma [[table\|tabela]] representando o quadro atual do áudio. Essa função permite a visualização do áudio.

Alvesvin at 00:02, 18 August 2021

2021-08-18T00:02:37Z

← Older revision		Revision as of 00:02, 18 August 2021
Line 47:		Line 47:

	==Veja também==		==Veja também==
	{{~~Client_audio_functions~~}}		{{PT-BR/Funcoes_audio_client}}

	[[EN:getSoundFFTData]]		[[EN:getSoundFFTData]]

Alvesvin at 19:16, 15 August 2021

2021-08-15T19:16:05Z

← Older revision		Revision as of 19:16, 15 August 2021
Line 9:		Line 9:

	==Sintaxe==		==Sintaxe==
	<syntaxhighlight lang="lua">table getSoundFFTData ( element audio, int ~~samples~~ [, int ~~bandas~~ = 0 ] )</syntaxhighlight>		<syntaxhighlight lang="lua">table getSoundFFTData ( element audio, int amostras [, int barras = 0 ] )</syntaxhighlight>

	{{BR/OOP\|\|[[sound\|audio]]:getFFTData}}		{{BR/OOP\|\|[[sound\|audio]]:getFFTData}}
Line 15:		Line 15:
	===Argumentos necessários===		===Argumentos necessários===
	*'''audio:''' um elemento de [[sound\|áudio]] criado usando [[playSound]] ou [[playSound3D]]. Streams também são suportadas.		*'''audio:''' um elemento de [[sound\|áudio]] criado usando [[playSound]] ou [[playSound3D]]. Streams também são suportadas.
	*'''~~samples~~:''' ~~samples~~ permitidos são: 256, 512, 1024, 2048, 4096, 8192 and 16384.		*'''amostras:''' amostras permitidos são: 256, 512, 1024, 2048, 4096, 8192 and 16384.

	===Argumentos opicionais===		===Argumentos opicionais===
	*'''~~bandas~~:''' uma opção de pós-processamento que te permite separar ~~os samples~~ na quantidade de bandas ou barras desejadas. Se você precisa apenas de cinco ~~bandas~~, utilizar esse argumento economiza bastante poder de processamento se comparado à tentativa de fazer isso em Lua.		*'''barras:''' uma opção de pós-processamento que te permite separar as amostras na quantidade de bandas ou barras desejadas. Se você precisa apenas de cinco barras, utilizar esse argumento economiza bastante poder de processamento se comparado à tentativa de fazer isso em Lua.

	===Retorno===		===Retorno===
	Retorna uma [[table\|tabela]] de '''~~samples~~'''/2 (ou dividido por '''~~bandas~~''' caso '''~~bandas~~''' forem usadas) ''floats'' representando o quadro atual do áudio. Retorna ''false'' se o áudio ainda não está sendo reproduzido ou ainda não foi carregado no caso de streams.		Retorna uma [[table\|tabela]] de '''amostras'''/2 (ou dividido por '''barras''' caso '''barras''' forem usadas) ''floats'' representando o quadro atual do áudio. Retorna ''false'' se o áudio ainda não está sendo reproduzido ou ainda não foi carregado no caso de streams.

	==Exemplo==		==Exemplo==

Alvesvin: Created page with "NOTOC {{BR/Funcao cliente}} Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma tabela representando o quad..."

2021-08-15T19:12:36Z

Created page with "__NOTOC__ {{BR/Funcao cliente}} Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma tabela representando o quad..."

New page

__NOTOC__
{{BR/Funcao cliente}}

Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma [[table|tabela]] representando o quadro atual do áudio. Essa função permite a visualização do áudio.

O algorítmo de Transformada Rápida de Fourier gera uma [[table|tabela]] com todas as frequências do quadro atual do áudio começando pelos graves, depois médios e então agudos. Se você tiver algum problema verifique o exemplo localizado no repositório de resources do MTA: [https://github.com/multitheftauto/mtasa-resources/tree/master/%5Bgameplay%5D/visualiser Visualizador de áudio].

Basta digitar ''"startmusic <url-da-stream>"'' no console e a visualização da música será reproduzida no outdoor do cinema proximo à Area 69. Se o elemento que executar esse comando for um [[player|jogador]], então essa função usará seu microfone para criar a visualização da stream de áudio.

==Sintaxe==
<syntaxhighlight lang="lua">table getSoundFFTData ( element audio, int samples [, int bandas = 0 ] )</syntaxhighlight>

{{BR/OOP||[[sound|audio]]:getFFTData}}

===Argumentos necessários===
*'''audio:''' um elemento de [[sound|áudio]] criado usando [[playSound]] ou [[playSound3D]]. Streams também são suportadas.
*'''samples:''' samples permitidos são: 256, 512, 1024, 2048, 4096, 8192 and 16384.

===Argumentos opicionais===
*'''bandas:''' uma opção de pós-processamento que te permite separar os samples na quantidade de bandas ou barras desejadas. Se você precisa apenas de cinco bandas, utilizar esse argumento economiza bastante poder de processamento se comparado à tentativa de fazer isso em Lua.

===Retorno===
Retorna uma [[table|tabela]] de '''samples'''/2 (ou dividido por '''bandas''' caso '''bandas''' forem usadas) ''floats'' representando o quadro atual do áudio. Retorna ''false'' se o áudio ainda não está sendo reproduzido ou ainda não foi carregado no caso de streams.

==Exemplo==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local audio = playSound ( "audio.wav" )

function onSoundPlayRender ( )
if ( audio ) then
local audioFFT = getSoundFFTData ( audio, 2048, 256 )
if ( audioFFT ) then
for i = 0, 255 do -- Os dados começam no índice 0
dxDrawRectangle ( i, 0, 1, math.sqrt ( audioFFT[i] ) * 256 )
end
end
end
end
addEventHandler ( "onClientRender", root, onSoundPlayRender )
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}

==Veja também==
{{Client_audio_functions}}

[[EN:getSoundFFTData]]
[[HU:getSoundFFTData]]
[[ES:getSoundFFTData]]
[[AR:getSoundFFTData]]

PT-BR/getSoundFFTData - Revision history

LordHenry at 20:07, 1 April 2023

Alvesvin at 00:02, 18 August 2021

Alvesvin at 19:16, 15 August 2021

Alvesvin: Created page with "__NOTOC__ {{BR/Funcao cliente}} Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma tabela representando o quad..."

Alvesvin: Created page with "NOTOC {{BR/Funcao cliente}} Essa função obtém os dados de Transformada Rápida de Fourier de uma stream de áudio ao qual é uma tabela representando o quad..."