# getCinematicActorPose (Cliente)

> Devolve onde um ator está num tempo da cinemática. Não precisa de reprodução.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Cliente
- **Categoria**: Cinemáticas
- **URL**: https://wiki.mymp.gg/pt/getCinematicActorPose

## Sintaxe

```lua
vec3, vec3|false getCinematicActorPose(cinematic cinematic, string slot, int time [, bool adjusted = true])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `slot` | `string` | Nome do ator. |
| `time` | `int` | Tempo da cinemática em ms, de 0 para cima. |
| `adjusted` | `bool` | `true` para a pose com os deslocamentos de `setCinematicAdjustments`, `false` para a pose como foi gravada. *(padrão: `true`)* |

## Retorno

A posição e a rotação em graus, cada uma um `vec3`, ou `false` se o ator não existe ou não aparece nesse tempo.

## Exemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
local position, rotation = getCinematicActorPose(intro, "hero", 5000)
if position then
    outputDebugString(("herói em %.1f, %.1f, %.1f virado para %.0f"):format(position.x, position.y, position.z, rotation.z))
end
```

## Veja também

- [setCinematicAdjustments (Cliente)](https://wiki.mymp.gg/pt/setCinematicAdjustments.md): Põe deslocamentos e animações por cima da tomada de um ator. A tomada fica como foi gravada e se move junto. Substitui os ajustes anteriores do ator.
- [getCinematicActors (Cliente)](https://wiki.mymp.gg/pt/getCinematicActors.md): Lista os atores da cinemática: os gravados e os posicionados.
- [getCinematicShotView (Cliente)](https://wiki.mymp.gg/pt/getCinematicShotView.md): Devolve onde a câmera de um plano está e para onde olha num tempo da cinemática, com o tremor.