# getCinematicActors (Client)

> Lists the cinematic's actors: the recorded ones and the placed ones.

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

## Syntax

```lua
table|false getCinematicActors(cinematic cinematic)
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `cinematic` | `cinematic` | The cinematic. |

## Returns

A table with one entry per actor, or `false` if the element is not a cinematic.

### Common fields

Every actor entry includes:

- `slot`: the actor's name.
- `type`: `"ped"`, `"vehicle"` or `"object"`.
- `recorded`: `true` if the actor has a recorded take, `false` otherwise.

### Placed actors

An actor placed with `setCinematicProp` also includes:

- `placed`: `true`.
- `model`: model ID or name.
- `position` and `rotation`: `vec3` values (`rotation` in degrees).
- `start` and `stop`: visibility window in cinematic ms.

### Recorded actors

A recorded actor also includes:

- `at`, `speed`, `start` and `stop` (the part shown), plus `takeStart` and `takeEnd` (where the take starts and ends), all in cinematic ms.
- `voice`: how many voice frames the actor spoke.
- `seats`: a list of `{ time, change, vehicle, seat }` entries, where `change` is `"entering"`, `"in"`, `"leaving"` or `"out"`, `vehicle` is the vehicle actor's name and `seat` is the seat index (`0` is the driver's).

## Example

```lua
local intro = createCinematic("cinematics/intro.cine")
for _, actor in ipairs(getCinematicActors(intro)) do
    outputDebugString(("%s (%s) from %d to %d ms"):format(actor.slot, actor.type, actor.start, actor.stop))
end
```

## See also

- [getCinematicActor (Client)](https://wiki.mymp.gg/en/getCinematicActor.md): Returns the local element (ped or vehicle) that plays an actor in the current playback.
- [setCinematicActorTiming (Client)](https://wiki.mymp.gg/en/setCinematicActorTiming.md): Places an actor's take in the cinematic's time, trims the part shown and sets its speed. Outside that part the actor leaves the scene.
- [setCinematicProp (Client)](https://wiki.mymp.gg/en/setCinematicProp.md): Places a vehicle or object that stands still over a part of the cinematic, or changes one already placed.
- [removeCinematicActor (Client)](https://wiki.mymp.gg/en/removeCinematicActor.md): Takes an actor, with its take, out of the cinematic.