# getSoundWaveData (Cliente)

> Devolve a forma de onda do que o som acabou de tocar, para desenhar osciloscópios.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Som
- **URL**: https://wiki.mymp.gg/pt/getSoundWaveData

## Sintaxe

```lua
table|false getSoundWaveData(sound sound, int samples)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `sound` | `sound` | O elemento `sound`, ou um elemento `dui` para o som do navegador. |
| `samples` | `int` | Quantos valores devolver: uma potência de 2 entre 128 e 16384. |

## Retorno

Uma tabela com `samples` valores de -1 a 1, alternando canal esquerdo e direito, ou `false` se `samples` não vale ou o som está pausado, terminado ou fora de alcance.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    local wave = getSoundWaveData(music, 512)
    if not wave then return end
    for i = 0, 510, 2 do
        dxDrawLine(i, 300 + wave[i] * 100, i + 2, 300 + wave[i + 2] * 100, tocolor(255, 255, 255))
    end
end)
```

### Atenção

A tabela começa no índice 0.

## Veja também

- [getSoundFFTData (Cliente)](https://wiki.mymp.gg/pt/getSoundFFTData.md): Devolve o espectro de frequências do que o som está tocando agora, para fazer visualizadores.
- [getSoundLevelData (Cliente)](https://wiki.mymp.gg/pt/getSoundLevelData.md): Devolve o pico de volume de cada canal nos últimos 20 ms do som.