# dxDrawMaterialLine3D (Cliente)

> Desenha uma imagem esticada ao longo de uma linha no mundo 3D durante um quadro.

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

## Sintaxe

```lua
bool dxDrawMaterialLine3D(float startX, startY, startZ, float endX, endY, endZ, texture|dui material, float width [, bool flipUV = false, color color = tocolor(255, 255, 255), string|bool stage = postfx, float faceTowardX, faceTowardY, faceTowardZ = nil])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `startX, startY, startZ` | `float` | Ponto inicial no mundo, o topo da imagem. Aceita também um vec3. |
| `endX, endY, endZ` | `float` | Ponto final no mundo, a base da imagem. Aceita também um vec3. |
| `flipUV` | `bool` | Inverte a imagem. Pode ser omitido. *(padrão: `false`)* |
| `material` | `texture\|dui` | A imagem: textura, render target, screen source ou dui. |
| `width` | `float` | Largura da faixa, em unidades do mundo. |
| `color` | `color` | Cor que multiplica a imagem, um valor de `tocolor`. *(padrão: `tocolor(255, 255, 255)`)* |
| `stage` | `string\|bool` | Quando desenhar: `prefx`, `postfx` ou `postgui`, ou um booleano (`true` é `postgui`). *(padrão: `postfx`)* |
| `faceTowardX, faceTowardY, faceTowardZ` | `float` | Ponto para onde a face da imagem aponta. Sem ele, a imagem fica virada para a câmera. Aceita também um vec3. *(padrão: `nil`)* |

## Retorno

`true` se o desenho foi enfileirado.

## Exemplo

```lua
local sign = engineCreateTexture("images/sign.png")

addEventHandler("onClientRender", root, function()
    dxDrawMaterialLine3D(2488, -1666, 16, 2488, -1666, 14, sign, 2)
end)
```

### Atenção

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

## Veja também

- [dxDrawMaterialSectionLine3D (Cliente)](https://wiki.mymp.gg/pt/dxDrawMaterialSectionLine3D.md): Desenha uma parte de uma imagem esticada ao longo de uma linha no mundo 3D durante um quadro.
- [dxDrawLine3D (Cliente)](https://wiki.mymp.gg/pt/dxDrawLine3D.md): Desenha uma linha no mundo 3D durante um quadro. A linha fica virada para a câmera.
- [engineCreateTexture (Cliente)](https://wiki.mymp.gg/pt/engineCreateTexture.md): Cria uma textura a partir de um arquivo de imagem do recurso ou dos bytes de uma imagem na memória. A textura existe só neste cliente.
- [dxCreateRenderTarget (Cliente)](https://wiki.mymp.gg/pt/dxCreateRenderTarget.md): Cria um render target: uma imagem em que as funções dx podem desenhar e que pode ser usada como qualquer outra imagem.