Luzes

O MTAX tem dois tipos de luz, cada um com o seu conjunto de funções:

• luzes pontuais — elementos light que iluminam o mundo a partir de um ponto, com raio, cor e direção próprios;
• holofotes — elementos searchlight que desenham um cone de luz entre dois pontos, como o refletor de um helicóptero.

Os dois são elementos de verdade: aparecem em getElementType, somem com destroyElement e são destruídos automaticamente quando o resource que os criou para.

Quando um argumento inválido é passado — um elemento que não é luz, uma luz já destruída — a função devolve false e escreve o motivo no console de debug. As duas funções de cor do holofote são a exceção: elas geram um erro Lua.

Estas 19 funções existem somente no cliente. Chamá-las de um script de servidor resulta em erro de valor nulo.

Luzes pontuais

Uma luz pontual é redesenhada a cada quadro a partir do estado que você configurou. A posição dela vem do próprio elemento: não existe setLightPosition, você move a luz com setElementPosition e lê a posição com getElementPosition.

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

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.

Holofotes

Um holofote é um cone de luz definido por dois pontos e dois raios: onde o cone começa, onde ele termina, e a largura em cada uma dessas pontas. É o formato do refletor de um helicóptero.

Ao contrário das luzes pontuais, o holofote não acompanha a posição do elemento: as duas pontas são absolutas e você as move você mesmo, com setSearchLightStartPosition e setSearchLightEndPosition. Para fazer um holofote seguir alguma coisa, atualize as pontas em onClientRender ou num timer.

A posição do elemento é o ponto de origem do cone: getElementPosition devolve esse ponto, e setElementPosition não faz nada num holofote. O cone só é desenhado enquanto esse ponto de origem estiver a até cerca de 600 unidades da câmera, e só na dimensão 0 — um holofote movido para outra dimensão nunca é desenhado, qualquer que seja a dimensão do jogador.

createSearchLight Cria um cone de holofote entre dois pontos.

getSearchLightStartPosition Devolve o ponto de origem do cone.

setSearchLightStartPosition Move o ponto de origem do cone.

getSearchLightEndPosition Devolve o ponto final do cone.

setSearchLightEndPosition Move o ponto final do cone.

getSearchLightStartRadius Lê a largura do cone na origem.

setSearchLightStartRadius Altera a largura do cone na origem.

getSearchLightEndRadius Lê a largura do cone na ponta final.

setSearchLightEndRadius Altera a largura do cone na ponta final.

getSearchLightColor Devolve a cor do cone.

setSearchLightColor Altera a cor do cone.