# setElementMatrix (Compartilhado)

> Posiciona e gira um elemento a partir de uma matriz.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Elementos
- **URL**: https://wiki.mymp.gg/pt/setElementMatrix

## Sintaxe

```lua
bool setElementMatrix(element element, table matrix)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | O elemento. |
| `matrix` | `table` | Tabela de 4 linhas de 4 números, como a que `getElementMatrix` devolve: direita, frente, cima e posição. A quarta coluna é ignorada. |

## Retorno

`true` se aplicou, `false` se o elemento não tem posição e rotação ou se a matriz dá valores não finitos.

## Exemplo

```lua
local vehicle = getPedOccupiedVehicle(localPlayer)
if vehicle then
    local matrix = getElementMatrix(vehicle)
    matrix[4][3] = matrix[4][3] + 2
    setElementMatrix(vehicle, matrix)
end
```

### Atenção

Uma tabela que não tem 4 linhas de 4 números finitos dá erro.

## Veja também

- [getElementMatrix (Compartilhado)](https://wiki.mymp.gg/pt/getElementMatrix.md): Lê a matriz 4x4 de um elemento, feita da sua posição e rotação.
- [setElementPosition (Compartilhado)](https://wiki.mymp.gg/pt/setElementPosition.md): Move um elemento para uma posição no mundo.
- [setElementRotation (Compartilhado)](https://wiki.mymp.gg/pt/setElementRotation.md): Define a rotação 3D de um elemento em graus.