# dxDrawSpotLight (Cliente)

> Ilumina un cono durante un solo fotograma, sin crear un elemento.

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

## Sintaxis

```lua
bool dxDrawSpotLight(float x, y, z, float dirX, dirY, dirZ, float radius, color color [, float cone = 30, float hardness = 0.5, float intensity = 1, float falloff = 4, float sourceRadius = 0.1, bool castShadow = false])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y, z` | `float` | Posición de la luz en el mundo, tres números o un vec3. |
| `dirX, dirY, dirZ` | `float` | Hacia dónde apunta la luz. Tres números o un vec3, finito y no nulo; se normaliza. |
| `radius` | `float` | Alcance en metros, mayor que 0 y hasta 1000. |
| `color` | `color` | Tres números `r, g, b` (enteros de 0 a 255) o un valor de `tocolor`. El alfa se ignora. |
| `cone` | `float` | Mitad de la apertura del cono, en grados desde su eje, mayor que 0 y hasta 90. *(por defecto: `30`)* |
| `hardness` | `float` | Fracción del cono iluminada por completo, de 0 a 1. Por encima de 0.99 cuenta como 0.99. *(por defecto: `0.5`)* |
| `intensity` | `float` | Multiplicador de brillo, de 0 a 1000. En 1, una luz blanca brilla con una radiancia HDR de 12. *(por defecto: `1`)* |
| `falloff` | `float` | Exponente del desvanecimiento hacia el radio, de 0.1 a 32. Valores mayores mantienen la luz fuerte más cerca del borde. *(por defecto: `4`)* |
| `sourceRadius` | `float` | Radio de la bombilla en metros, de 0 hasta el alcance de la luz. Si se omite, 0.1 o el alcance, lo que sea menor. *(por defecto: `0.1`)* |
| `castShadow` | `bool` | Si la luz proyecta sombras. *(por defecto: `false`)* |

## Retorno

`true` si la luz entró en la cola del fotograma. `false` cuando ya hay 256 luces en la cola, o con un argumento incorrecto.

La luz dura un fotograma. Una llamada hecha antes de dibujar el mundo (por ejemplo en `onClientPreRender` u `onClientRender`) ilumina ese fotograma; una hecha después ilumina el siguiente. Las llamadas hechas mientras no corre ningún fotograma se descartan. Pasar de 256 luces en un fotograma registra un aviso una vez, hasta que un fotograma deja sitio en la cola.

## Ejemplo

```lua
addEventHandler("onClientPreRender", root, function()
    local pos = getElementPosition(localPlayer)
    local a = math.rad(getElementRotation(localPlayer).z)
    dxDrawSpotLight(pos.x, pos.y, pos.z + 0.6, -math.sin(a), math.cos(a), -0.2, 30, 255, 250, 230, 20)
end)
```

### Si vienes de MTA

MTA no tiene luces dinámicas.

## Ver también

- [createSpotLight (Cliente)](https://wiki.mymp.gg/es/createSpotLight.md): Crea una luz que ilumina dentro de un cono, como un foco. La luz solo existe en este cliente.
- [dxDrawPointLight (Cliente)](https://wiki.mymp.gg/es/dxDrawPointLight.md): Ilumina en todas las direcciones desde un punto durante un solo fotograma, sin crear un elemento.
- [dxDrawRectLight (Cliente)](https://wiki.mymp.gg/es/dxDrawRectLight.md): Ilumina desde un rectángulo durante un solo fotograma, sin crear un elemento.
- [onClientPreRender (Cliente)](https://wiki.mymp.gg/es/onClientPreRender.md): Se dispara en cada fotograma, después de simular el mundo y antes de dibujarlo.