# dxDrawMaterialSectionLine3D (Cliente)

> Dibuja una parte de 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/dxDrawMaterialSectionLine3D

## Sintaxis

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

| 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. |
| `u, v` | `float` | Esquina superior izquierda de la parte, en píxeles de la imagen. También acepta un vec2. |
| `usize, vsize` | `float` | Tamaño de la parte, en píxeles de la imagen. También acepta un vec2. |
| `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 atlas = engineCreateTexture("images/atlas.png")

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

### Atención

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

## Ver también

- [dxDrawMaterialLine3D (Cliente)](https://wiki.mymp.gg/es/dxDrawMaterialLine3D.md): Dibuja una imagen estirada a lo largo de una línea en el mundo 3D durante un fotograma.
- [dxDrawImageSection (Cliente)](https://wiki.mymp.gg/es/dxDrawImageSection.md): Dibuja una parte de una imagen en la pantalla durante un fotograma.
- [dxGetMaterialSize (Cliente)](https://wiki.mymp.gg/es/dxGetMaterialSize.md): Devuelve el tamaño de una imagen en píxeles.