setCameraMatrix

Coloca a câmera do jogador numa posição fixa.

Sintaxe

-- servidor
bool setCameraMatrix ( element oJogador, number x, number y, number z [, number miraX, number miraY, number miraZ, number rolagem = 0, number fov = 70 ] )

-- cliente
bool setCameraMatrix ( number x, number y, number z [, number miraX, number miraY, number miraZ, number rolagem = 0, number fov = 70 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oJogador	element	—	Só no servidor. Jogador (ou elemento acima dele na árvore).
x, y, z	number	—	Posição da câmera no mundo.
miraX, miraY, miraZ	number	veja abaixo	Ponto para onde a câmera olha.
rolagem	number	0	Inclinação da câmera, em graus.
fov	number	70	Campo de visão, em graus.

Sem o ponto de mira, cada lado usa um padrão diferente: no servidor a câmera passa a olhar para 0, 0, 0; no cliente ela continua virada para onde já estava (ou, se já estava parada por um setCameraMatrix anterior, para o ponto de mira daquela chamada). Se você quer o mesmo resultado nos dois lados, informe a mira.

Valores de fov menores ou iguais a 0, ou maiores ou iguais a 180, são substituídos por 70.

Retorno

true em caso de sucesso. No servidor, false quando o primeiro argumento não é um elemento válido. Uma coordenada que não seja número devolve false com um aviso no console de debug.

Vector3 e Matrix

Nos dois lados, cada trio de coordenadas pode ser trocado por um Vector3:

setCameraMatrix(jogador, Vector3(1481.0, -1750.0, 40.0), Vector3(1481.0, -1690.0, 13.0))  -- servidor
setCameraMatrix(Vector3(1481.0, -1750.0, 40.0), Vector3(1481.0, -1690.0, 13.0))           -- cliente

A forma que recebe um Matrix inteiro só existe no cliente, porque a matriz precisa ser o primeiro argumento e no servidor esse lugar é do jogador. Como no MTA, só a posição sai de fato da matriz: a rotação dela, em radianos, é passada como ponto de mira, então a câmera acaba olhando para um ponto perto da origem do mundo. Informe a mira você mesmo se precisar de um enquadramento de verdade:

setCameraMatrix(minhaMatriz)                                        -- cliente: só a posição
setCameraMatrix(minhaMatriz.position, minhaMatriz.position + minhaMatriz.forward)   -- cliente: olha na direção da matriz

Exemplo

-- servidor: câmera parada olhando para o centro da praça
setCameraMatrix(jogador, 1481.0, -1750.0, 40.0, 1481.0, -1690.0, 13.0)

-- cliente: a mesma câmera, sem o argumento do jogador
setCameraMatrix(1481.0, -1750.0, 40.0, 1481.0, -1690.0, 13.0)

Veja também

• 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á.
• fadeCamera — Escurece a tela do jogador ou traz a imagem de volta.