# dxDrawMaterialSectionLine3D (Cliente)

> Desenha uma parte de 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/dxDrawMaterialSectionLine3D

## Sintaxe

```lua
bool dxDrawMaterialSectionLine3D(float startX, startY, startZ, float endX, endY, endZ, float u, v, float usize, vsize, 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. |
| `u, v` | `float` | Canto superior esquerdo da parte, em pixels da imagem. Aceita também um vec2. |
| `usize, vsize` | `float` | Tamanho da parte, em pixels da imagem. Aceita também um vec2. |
| `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 atlas = engineCreateTexture("images/atlas.png")

addEventHandler("onClientRender", root, function()
    dxDrawMaterialSectionLine3D(2488, -1666, 16, 2488, -1666, 14, 0, 0, 64, 64, atlas, 2)
end)
```

### Atenção

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

## Veja também

- [dxDrawMaterialLine3D (Cliente)](https://wiki.mymp.gg/pt/dxDrawMaterialLine3D.md): Desenha uma imagem esticada ao longo de uma linha no mundo 3D durante um quadro.
- [dxDrawImageSection (Cliente)](https://wiki.mymp.gg/pt/dxDrawImageSection.md): Desenha uma parte de uma imagem na tela durante um quadro.
- [dxGetMaterialSize (Cliente)](https://wiki.mymp.gg/pt/dxGetMaterialSize.md): Devolve o tamanho de uma imagem em pixels.