# dxDrawMaterialLine3D (Cliente)

> Dibuja una imagen estirada a lo largo de una línea en el mundo 3D durante un fotograma.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Dibujo en pantalla
- **URL**: https://wiki.mymp.gg/es/dxDrawMaterialLine3D

## Sintaxis

```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

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `startX, startY, startZ` | `float` | Punto inicial en el mundo, la parte superior de la imagen. También acepta un vec3. |
| `endX, endY, endZ` | `float` | Punto final en el mundo, la parte inferior de la imagen. También acepta un vec3. |
| `flipUV` | `bool` | Invierte la imagen. Se puede omitir. *(por defecto: `false`)* |
| `material` | `texture\|dui` | La imagen: textura, render target, screen source o dui. |
| `width` | `float` | Ancho de la franja, en unidades del mundo. |
| `color` | `color` | Color que multiplica la imagen, un valor de `tocolor`. *(por defecto: `tocolor(255, 255, 255)`)* |
| `stage` | `string\|bool` | Cuándo dibujar: `prefx`, `postfx` o `postgui`, o un booleano (`true` es `postgui`). *(por defecto: `postfx`)* |
| `faceTowardX, faceTowardY, faceTowardZ` | `float` | Punto hacia el que mira la cara de la imagen. Sin él, la imagen mira a la cámara. También acepta un vec3. *(por defecto: `nil`)* |

## Retorno

`true` si el dibujo quedó en cola.

## Ejemplo

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

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

### Atención

`prefx` y `postfx` dibujan igual: solo `postgui` cambia la capa.

## Ver también

- [dxDrawMaterialSectionLine3D (Cliente)](https://wiki.mymp.gg/es/dxDrawMaterialSectionLine3D.md): Dibuja una parte de una imagen estirada a lo largo de una línea en el mundo 3D durante un fotograma.
- [dxDrawLine3D (Cliente)](https://wiki.mymp.gg/es/dxDrawLine3D.md): Dibuja una línea en el mundo 3D durante un fotograma. La línea mira a la cámara.
- [engineCreateTexture (Cliente)](https://wiki.mymp.gg/es/engineCreateTexture.md): Crea una textura a partir de un archivo de imagen del recurso o de los bytes de una imagen en memoria. La textura solo existe en este cliente.
- [dxCreateRenderTarget (Cliente)](https://wiki.mymp.gg/es/dxCreateRenderTarget.md): Crea un render target: una imagen en la que las funciones dx pueden dibujar y que se puede usar como cualquier otra imagen.