# getCinematicActorPose (Client)

> Returns where an actor stands at a cinematic time. It needs no playback.

- **Platform**: MY Multiplayer (MYMP)
- **Kind**: Lua Function
- **Side**: Client
- **Category**: Cinematics
- **URL**: https://wiki.mymp.gg/en/getCinematicActorPose

## Syntax

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

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `cinematic` | `cinematic` | The cinematic. |
| `slot` | `string` | The actor's name. |
| `time` | `int` | Cinematic time in ms, from 0 up. |
| `adjusted` | `bool` | `true` for the pose with the shifts of `setCinematicAdjustments`, `false` for the pose as recorded. *(default: `true`)* |

## Returns

The position and the rotation in degrees, each a `vec3`, or `false` if the actor does not exist or is not shown at that time.

## Example

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

## See also

- [setCinematicAdjustments (Client)](https://wiki.mymp.gg/en/setCinematicAdjustments.md): Lays shifts and animations over an actor's take. The take stays as recorded and moves with them. It replaces the actor's earlier adjustments.
- [getCinematicActors (Client)](https://wiki.mymp.gg/en/getCinematicActors.md): Lists the cinematic's actors: the recorded ones and the placed ones.
- [getCinematicShotView (Client)](https://wiki.mymp.gg/en/getCinematicShotView.md): Returns where a shot's camera stands and what it looks at, at a cinematic time, shake included.