# createRectLight (Cliente)

> Crea una luz que sale de un rectángulo, como un panel o una ventana iluminada. La luz solo existe en este cliente.

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

## Sintaxis

```lua
light|false createRectLight(float x, y, z, float normalX, normalY, normalZ [, float radius = 8, color color = tocolor(255, 255, 255), float width = 1, float height = 1])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `x, y, z` | `float` | Posición de la luz en el mundo, tres números o un vec3. |
| `normalX, normalY, normalZ` | `float` | Hacia dónde apunta la cara del rectángulo. Tres números o un vec3, finito y no nulo; se normaliza. La luz solo ilumina por delante. |
| `radius` | `float` | Alcance en metros, mayor que 0 y hasta 1000. *(por defecto: `8`)* |
| `color` | `color` | Tres números `r, g, b` (enteros de 0 a 255) o un valor de `tocolor`. El alfa se ignora. *(por defecto: `tocolor(255, 255, 255)`)* |
| `width` | `float` | Ancho del rectángulo en metros, de 0.01 a 100. *(por defecto: `1`)* |
| `height` | `float` | Alto del rectángulo en metros, de 0.01 a 100. *(por defecto: `1`)* |

## Retorno

El elemento `light` creado, o `false` si no se pudo crear.

El ancho sigue una tangente hecha a partir de la normal y del eje vertical del mundo; cámbiala con `setLightTangent`. Las aletas empiezan a 88 grados y 0.2 metros, o sea, sin tapar nada. Una luz fuera de la dimensión o del área en foco no se dibuja.

## Ejemplo

```lua
local light = createRectLight(1481.0, -1771.0, 22.0, 0, -1, 0, 12, 200, 220, 255, 4, 0.5)
setLightIntensity(light, 3)
```

### Si vienes de MTA

MTA no tiene luces dinámicas. Para iluminar un solo fotograma sin crear un elemento, usa `dxDrawRectLight`.

## 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.
- [setLightSize (Cliente)](https://wiki.mymp.gg/es/setLightSize.md): Cambia el ancho y el alto de una luz rect.
- [setLightBarnDoor (Cliente)](https://wiki.mymp.gg/es/setLightBarnDoor.md): Cambia las aletas de una luz rect, que limitan hacia dónde sale la luz del rectángulo.
- [dxDrawRectLight (Cliente)](https://wiki.mymp.gg/es/dxDrawRectLight.md): Ilumina desde un rectángulo durante un solo fotograma, sin crear un elemento.