Alvesvin at 00:05, 18 August 2021

2021-08-18T00:05:00Z

← Older revision		Revision as of 00:05, 18 August 2021
Line 107:		Line 107:

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

	[[en:getSoundWaveData]]		[[en:getSoundWaveData]]
	[[hu:getSoundWaveData]]		[[hu:getSoundWaveData]]
	[[ar:getSoundWaveData]]		[[ar:getSoundWaveData]]

Alvesvin: Created page with "NOTOC {{Client function}} Essa função obtém os dados do formato da onda de um áudio os quais são uma tabela de floats representando o quadro atua..."

2021-08-17T23:44:56Z

Created page with "__NOTOC__ {{Client function}} Essa função obtém os dados do formato da onda de um áudio os quais são uma tabela de floats representando o quadro atua..."

New page

__NOTOC__
{{Client function}}
Essa função obtém os dados do formato da onda de um [[sound|áudio]] os quais são uma tabela de [[float|floats]] representando o quadro atual. Essa função permite a visualização do áudio.

{{New feature/item|3.0132|1.3.2||
Se o elemento passado no primeiro argumento for um [[player|jogador]], essa função usará sua voz.
}}

==Sintaxe==
<syntaxhighlight lang="lua">table getSoundWaveData ( element audio, int amostras )</syntaxhighlight>

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

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

===Retorno===
Retorna uma [[table|tabela]] com a quantidade de [[float|floats]] definida em '''amostras''' representando a onda do quadro atual do [[sound|áudio]].
Retorna ''false'' caso o [[sound|áudio]] não está sendo reproduzido ou a stream ainda não foi carregada.

==Exemplo==
Esse exemplo cria um visualizador de áudio no canto superior esquerdo da tela.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local audio = playSound ( "audio.mp3" )

function onSoundPlayRender ( )
if ( audio ) then
local onda = getSoundWaveData ( audio, 256 )
if ( onda ) then
for i=0,255 do
dxDrawRectangle ( i, 128, 1, onda[i] * 128)
end
end
end
end

addEventHandler ( "onClientRender", root, onSoundPlayRender )
</syntaxhighlight>
</section>

Este exemplo cria um visualizador de áudio, mas apebas com as barras de baixo.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local audio = playSound ("audio.mp3")

function renderWave ()
if (isElement (audio)) then
local onda = getSoundWaveData (audio, 256)
for i=0, 256 - 1 do
if (onda) then -- Avoid NaN values.
dxDrawRectangle (i, 128, 1, math.abs (onda[i]) * 128)
end
end
end
end

addEventHandler ("onClientRender", root, renderWave)
</syntaxhighlight>
</section>

Esse exemplo criar um visualizador de áudio, mas apenas com as barras de cima.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local audio = playSound ("audio.mp3")

function renderWave ()
if (isElement (audio)) then
local onda = getSoundWaveData (audio, 256)
for i=0, 256 - 1 do
if (onda) then -- Avoid NaN values.
dxDrawRectangle (i, 128, 1, math.abs (onda[i]) * -128)
end
end
end
end

addEventHandler ("onClientRender", root, renderWave)
</syntaxhighlight>
</section>

Esse exemplo cria um visualizador de áudio no canto inferior direito da tela.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
local audio = playSound ("audio.mp3")
local x, y = guiGetScreenSize ()

function renderWave ()
if (isElement (audio)) then
local onda = getSoundWaveData (audio, 256)
for i=0, 256 - 1 do
if (onda) then -- Avoid NaN values.
dxDrawRectangle ((x-256)+i, y-128, 1, onda[i] * 128)
end
end
end
end

addEventHandler ("onClientRender", root, renderWave)
</syntaxhighlight>
</section>

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

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

[[en:getSoundWaveData]]
[[hu:getSoundWaveData]]
[[ar:getSoundWaveData]]

PT-BR/getSoundWaveData - Revision history

Alvesvin at 00:05, 18 August 2021

Alvesvin: Created page with "__NOTOC__ {{Client function}} Essa função obtém os dados do formato da onda de um áudio os quais são uma tabela de floats representando o quadro atua..."

Alvesvin: Created page with "NOTOC {{Client function}} Essa função obtém os dados do formato da onda de um áudio os quais são uma tabela de floats representando o quadro atua..."