# createSpotLight (Cliente)

> Cria uma luz que ilumina dentro de um cone, como um holofote. A luz existe só neste cliente.

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

## Sintaxe

```lua
light|false createSpotLight(float x, y, z, float dirX, dirY, dirZ [, float radius = 15, color color = tocolor(255, 255, 255), float cone = 30, float hardness = 0.5])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | Posição da luz no mundo, três números ou um vec3. |
| `dirX, dirY, dirZ` | `float` | Para onde a luz aponta. Três números ou um vec3, finito e não nulo; é normalizado. |
| `radius` | `float` | Alcance em metros, maior que 0 e até 1000. *(padrão: `15`)* |
| `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)`)* |
| `cone` | `float` | Metade da abertura do cone, em graus a partir do eixo, maior que 0 e até 90. *(padrão: `30`)* |
| `hardness` | `float` | Parte do cone iluminada por inteiro, de 0 a 1. Acima de 0.99 vale 0.99. *(padrão: `0.5`)* |

## Retorno

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

O raio da fonte começa em 0.1 metro (ou no alcance, se for menor); mude com `setLightSourceRadius`. Uma luz fora da dimensão ou da área em foco não é desenhada.

## Exemplo

```lua
local pos = getElementPosition(localPlayer)
local light = createSpotLight(pos.x, pos.y, pos.z + 6, 0, 0, -1, 20, 255, 240, 200, 25, 0.7)
setLightCastShadow(light, true)
```

### Vindo do MTA

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

## 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.
- [setLightCone (Cliente)](https://wiki.mymp.gg/pt/setLightCone.md): Muda a abertura e a dureza da borda do cone de uma luz spot.
- [setLightDirection (Cliente)](https://wiki.mymp.gg/pt/setLightDirection.md): Muda para onde uma luz spot ou rect aponta.
- [dxDrawSpotLight (Cliente)](https://wiki.mymp.gg/pt/dxDrawSpotLight.md): Acende uma luz dentro de um cone por um único quadro, sem criar elemento.