createSpotLight
Cliente
Cria uma luz que ilumina dentro de um cone, como um holofote. A luz existe só neste cliente.
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
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 MTAO MTA não tem luzes dinâmicas. Para iluminar um único quadro sem criar elemento, use
dxDrawSpotLight.