# attachCameraToElement (Cliente)

> Prende a câmera a um elemento: ela acompanha a posição e a rotação dele até `setCameraTarget` devolvê-la a um ped.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Câmera
- **URL**: https://wiki.mymp.gg/pt/attachCameraToElement

## Sintaxe

```lua
bool attachCameraToElement(element element, float offsetX, offsetY, offsetZ [, vec3|element lookAt = nil, float roll = 0, float fov = 70])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | O elemento que carrega a câmera. |
| `offsetX, offsetY, offsetZ` | `float` | Onde a câmera fica, relativo ao elemento. `0, 0, 0` vira 2 m acima dele. Também aceita um `vec3`. |
| `lookAt` | `vec3\|element` | Para onde ela olha: um ponto relativo ao elemento, como vetor, ou outro elemento a seguir. Sem ele, olha para o próprio elemento. *(padrão: `nil`)* |
| `roll` | `float` | A inclinação lateral, em graus. *(padrão: `0`)* |
| `fov` | `float` | O campo de visão em graus. 0 ou menos vira 70; 180 ou mais vira 179. *(padrão: `70`)* |

## Retorno

`true` se a câmera foi presa. `false` se o elemento ou o alvo não está carregado.

Se o elemento deixa de existir, a câmera volta ao jogador.

## Exemplo

```lua
local vehicle = getPedOccupiedVehicle(localPlayer)
if vehicle then
    attachCameraToElement(vehicle, 0, -6, 2, vec3(0, 4, 0.5))
end
```

### Atenção

O ponto para onde olhar precisa ser um vetor (`vec3(x, y, z)`); três números soltos são recusados com um aviso.

## Veja também

- [setCameraTarget (Cliente)](https://wiki.mymp.gg/pt/setCameraTarget.md): Põe a câmera para seguir um jogador ou ped, como no jogo normal. Também desfaz setCameraMatrix e attachCameraToElement.
- [setCameraMatrix (Cliente)](https://wiki.mymp.gg/pt/setCameraMatrix.md): Fixa a câmera num ponto, olhando para outro, até setCameraTarget devolvê-la a um ped.
- [getCameraMatrix (Cliente)](https://wiki.mymp.gg/pt/getCameraMatrix.md): Devolve onde a câmera está e para onde olha.