# getElementMatrix (Compartilhado)

> Lê a matriz 4x4 de um elemento, feita da sua posição e rotação.

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

## Sintaxe

```lua
table|false getElementMatrix(element element [, bool legacy = true])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | Elemento a ler. |
| `legacy` | `bool` | Com `true`, o quarto número das três primeiras linhas é 1. Com `false`, é 0. *(padrão: `true`)* |

## Retorno

Uma tabela de quatro linhas de quatro números: direita, frente, cima e posição. `false` se o elemento não tem posição ou rotação.

O quarto número da linha da posição é sempre 1.

## Exemplo

```lua
local m = getElementMatrix(localPlayer, false)
local x = m[4][1] + m[2][1] * 3
local y = m[4][2] + m[2][2] * 3
local z = m[4][3] + m[2][3] * 3
createObject("trafficcone", x, y, z)
```

## Veja também

- [setElementMatrix (Compartilhado)](https://wiki.mymp.gg/pt/setElementMatrix.md): Posiciona e gira um elemento a partir de uma matriz.
- [getElementPosition (Compartilhado)](https://wiki.mymp.gg/pt/getElementPosition.md): Lê a posição de um elemento no mundo.
- [getElementRotation (Compartilhado)](https://wiki.mymp.gg/pt/getElementRotation.md): Lê a rotação de um elemento em graus.