fadeCamera

Escurece a tela do jogador ou traz a imagem de volta.

Sintaxe

-- servidor
bool fadeCamera ( element oJogador, bool aparecer [, number duracao = 1.0, number vermelho = 0, number verde = 0, number azul = 0 ] )

-- cliente
bool fadeCamera ( bool aparecer [, number duracao = 1.0, number vermelho = 0, number verde = 0, number azul = 0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oJogador	element	—	Só no servidor. Jogador (ou elemento acima dele na árvore).
aparecer	bool	—	true traz a imagem de volta, false cobre a tela.
duracao	number	1.0	Duração do efeito, em segundos. No servidor, valores negativos viram 0.
vermelho	number	0	Canal vermelho da cor da tela, de 0 a 255.
verde	number	0	Canal verde da cor da tela, de 0 a 255.
azul	number	0	Canal azul da cor da tela, de 0 a 255.

No servidor, valores de cor fora de 0-255 são ajustados para o limite mais próximo. O cliente não ajusta: uma cor negativa é recusada, e acima de 255 só o byte mais baixo é aproveitado (300 vira 44).

Retorno

true em caso de sucesso. No servidor, false quando o primeiro argumento não é um elemento válido. No cliente, um argumento do tipo errado ou uma cor negativa devolve false com um aviso no console de debug.

Exemplo

-- servidor: escurece em meio segundo, teleporta e volta
fadeCamera(jogador, false, 0.5)
setTimer(function()
    setElementPosition(jogador, 2489.0, -1666.0, 13.4)
    fadeCamera(jogador, true, 1.0)
end, 600, 1)

-- cliente: escurece a tela local em vermelho
fadeCamera(false, 0.5, 255, 0, 0)

Veja também

• setCameraMatrix — Coloca a câmera do jogador numa posição fixa.
• getCameraMatrix — Devolve a posição e o enquadramento da câmera do jogador.
• setCameraTarget — Faz a câmera do jogador seguir um elemento.
• getCameraTarget — Devolve o elemento que a câmera do jogador está seguindo.
• setCameraInterior — Define em qual interior a câmera do jogador desenha o mundo.
• getCameraInterior — Devolve o interior em que a câmera do jogador está.