createLight

Cria uma luz pontual numa posição do mundo.

Sintaxe

light createLight ( number tipo, number x, number y, number z [, number raio = 3, number r = 255, number g = 0, number b = 0, number dirX = 0, number dirY = 0, number dirZ = 0, bool projetaSombra = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
tipo	number	—	Tipo da luz, que decide o modo de desenho usado. Não há validação: qualquer número é aceito e devolvido depois por getLightType.
x, y, z	number	—	Posição da luz no mundo.
raio	number	3	Alcance da luz, em unidades do jogo.
r	number	255	Canal vermelho, 0 – 255.
g	number	0	Canal verde, 0 – 255.
b	number	0	Canal azul, 0 – 255.
dirX, dirY, dirZ	number	0	Vetor de direção da luz. Só importa para os tipos que apontam para algum lado.
projetaSombra	bool	false	Aceito por compatibilidade com o MTA, mas ignorado: a luz nunca projeta sombra.

Os valores de cor não são limitados: o número é truncado para inteiro e só o byte mais baixo é mantido (300 vira 44). Um valor de cor negativo, uma string que não é número ou um NaN registra um aviso e devolve false. Números passados como string ("255") são aceitos.

Retorno

O elemento da luz, ou false se ela não pôde ser criada.

Exemplo

-- luz azul piscando em cima do jogador
local x, y, z = getElementPosition(localPlayer)
local giroflex = createLight(0, x, y, z + 1.5, 8, 0, 80, 255)

setTimer(function()
    if not isElement(giroflex) then return end
    local r = getLightColor(giroflex)
    if r == 0 then
        setLightColor(giroflex, 255, 0, 0)
    else
        setLightColor(giroflex, 0, 80, 255)
    end
end, 400, 0)

Veja também

• getLightType — Devolve o tipo com que a luz foi criada.
• getLightRadius — Lê o alcance da luz.
• setLightRadius — Altera o alcance da luz.
• getLightColor — Devolve a cor da luz.
• setLightColor — Altera a cor da luz.
• getLightDirection — Devolve o vetor de direção da luz.
• setLightDirection — Altera o vetor de direção da luz.