# dxDrawLine3D (Cliente)

> Desenha uma linha no mundo 3D durante um quadro. A linha fica virada para a câmera.

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

## Sintaxe

```lua
bool dxDrawLine3D(float startX, startY, startZ, float endX, endY, endZ [, color color = tocolor(255, 255, 255), float width = 1, string|bool stage = postfx])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `startX, startY, startZ` | `float` | Ponto inicial no mundo. Aceita também um vec3. |
| `endX, endY, endZ` | `float` | Ponto final no mundo. Aceita também um vec3. |
| `color` | `color` | Cor, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `width` | `float` | Espessura. *(padrão: `1`)* |
| `stage` | `string\|bool` | Quando desenhar: `prefx`, `postfx` ou `postgui`, ou um booleano (`true` é `postgui`). *(padrão: `postfx`)* |

## Retorno

`true` se o desenho foi enfileirado.

## Exemplo

```lua
addEventHandler("onClientRender", root, function()
    local pos = getElementPosition(localPlayer)
    dxDrawLine3D(pos.x, pos.y, pos.z, pos.x, pos.y, pos.z + 3, tocolor(255, 0, 0), 4)
end)
```

### Atenção

`prefx` e `postfx` desenham da mesma forma: só `postgui` muda a camada.

## Veja também

- [dxDrawLine (Cliente)](https://wiki.mymp.gg/pt/dxDrawLine.md): Desenha uma linha 2D na tela durante um quadro.
- [dxDrawMaterialLine3D (Cliente)](https://wiki.mymp.gg/pt/dxDrawMaterialLine3D.md): Desenha uma imagem esticada ao longo de uma linha no mundo 3D durante um quadro.
- [onClientRender (Cliente)](https://wiki.mymp.gg/pt/onClientRender.md): Disparado a cada quadro, quando os desenhos dx daquele quadro devem ser feitos.