# dxDrawPointLight (Cliente)

> Ilumina en todas las direcciones desde un punto 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/dxDrawPointLight

## Sintaxis

```lua
bool dxDrawPointLight(float x, y, z, float radius, color color [, float intensity = 1, float falloff = 4, 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. |
| `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. |
| `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`)* |
| `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)
    dxDrawPointLight(pos.x, pos.y, pos.z + 1, 6, 120, 180, 255, 2)
end)
```

### Si vienes de MTA

MTA no tiene luces dinámicas.

## Ver también

- [createPointLight (Cliente)](https://wiki.mymp.gg/es/createPointLight.md): Crea una luz que ilumina en todas las direcciones desde un punto. La luz solo existe en este cliente.
- [dxDrawSpotLight (Cliente)](https://wiki.mymp.gg/es/dxDrawSpotLight.md): Ilumina un cono 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.