# createRectLight (Cliente)

> Cria uma luz que sai de um retângulo, como um painel ou uma janela iluminada. A luz existe só neste cliente.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Luzes
- **URL**: https://wiki.mymp.gg/pt/createRectLight

## Sintaxe

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

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | Posição da luz no mundo, três números ou um vec3. |
| `normalX, normalY, normalZ` | `float` | Para onde a face do retângulo aponta. Três números ou um vec3, finito e não nulo; é normalizado. A luz só ilumina na frente. |
| `radius` | `float` | Alcance em metros, maior que 0 e até 1000. *(padrão: `8`)* |
| `color` | `color` | Três números `r, g, b` (inteiros de 0 a 255) ou um valor de `tocolor`. O alfa é ignorado. *(padrão: `tocolor(255, 255, 255)`)* |
| `width` | `float` | Largura do retângulo em metros, de 0.01 a 100. *(padrão: `1`)* |
| `height` | `float` | Altura do retângulo em metros, de 0.01 a 100. *(padrão: `1`)* |

## Retorno

O elemento `light` criado, ou `false` se não pôde ser criado.

A largura segue uma tangente feita a partir da normal e do eixo vertical do mundo; mude com `setLightTangent`. As abas começam a 88 graus e 0.2 metro, ou seja, sem cortar nada. Uma luz fora da dimensão ou da área em foco não é desenhada.

## Exemplo

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

### Vindo do MTA

O MTA não tem luzes dinâmicas. Para iluminar um único quadro sem criar elemento, use `dxDrawRectLight`.

## Veja também

- [createPointLight (Cliente)](https://wiki.mymp.gg/pt/createPointLight.md): Cria uma luz que ilumina em todas as direções a partir de um ponto. A luz existe só neste cliente.
- [setLightSize (Cliente)](https://wiki.mymp.gg/pt/setLightSize.md): Muda a largura e a altura de uma luz rect.
- [setLightBarnDoor (Cliente)](https://wiki.mymp.gg/pt/setLightBarnDoor.md): Muda as abas de uma luz rect, que limitam para onde a luz sai do retângulo.
- [dxDrawRectLight (Cliente)](https://wiki.mymp.gg/pt/dxDrawRectLight.md): Acende uma luz que sai de um retângulo por um único quadro, sem criar elemento.