setElementMatrix

Define a matriz de transformação e a posição de um elemento.

Sintaxe

bool setElementMatrix ( element oElemento, table matriz )

matriz precisa ter quatro linhas indexadas de 1 a 4: direita, frente, cima e posição, nessa ordem. No servidor cada linha deve trazer pelo menos três números finitos, e o quarto valor de cada linha, quando existir, é ignorado. No cliente a tabela precisa ser exatamente 4 × 4 — quatro linhas de quatro números — ou a chamada registra um aviso e devolve false; um objeto Matrix também é aceito.

setElementMatrix(porta, {
    { 1, 0, 0, 0 }, -- direita
    { 0, 1, 0, 0 }, -- frente
    { 0, 0, 1, 0 }, -- cima
    { 1500, -1700, 20, 1 } -- posição
})

Retorno

No servidor: true se a posição foi aplicada e, para um jogador, ped, veículo ou objeto, a base também foi aplicada; false para uma matriz incompleta, não finita ou degenerada, ou quando a transformação falha. No cliente: true assim que a matriz é lida.

O servidor normaliza os três vetores da base. Ele aplica a rotação somente ao elemento informado; a posição também é propagada aos descendentes que estiverem com propagação habilitada, sempre como uma posição absoluta e com warp ligado. O cliente aplica a matriz inteira, rotação incluída, ao elemento e a esses descendentes.

Veja também

• getElementPosition — Devolve a posição de um elemento no mundo.
• setElementPosition — Move um elemento para uma posição.
• getElementRotation — Devolve a rotação de um elemento, em graus.
• setElementRotation — Define a rotação de um elemento, em graus.
• getElementMatrix — Devolve a matriz de transformação de um elemento.
• getElementVelocity — Devolve a velocidade linear de um elemento.
• setElementVelocity — Define a velocidade linear de um elemento.
• getElementAngularVelocity — Devolve a velocidade de rotação de um elemento.