# setCinematicActorTiming (Cliente)

> Posiciona a tomada de um ator no tempo da cinemática, corta o trecho mostrado e define a velocidade. Fora desse trecho o ator sai de cena.

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

## Sintaxe

```lua
bool setCinematicActorTiming(cinematic cinematic, string slot, table timing)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `slot` | `string` | Nome de um ator gravado. |
| `timing` | `table` | Tabela com `at`, `start`, `stop` e `speed`, todos opcionais. |

## Retorno

`true` se aplicou. `false` se o ator não existe ou se a tabela é inválida, com um aviso dizendo o motivo.

Os campos, em ms da cinemática:

- `at`: onde o instante 0 da tomada toca. Pode ser negativo. Sem ele, fica o atual.
- `start`: a partir de quando o ator aparece. Sem ele, fica o atual.
- `stop`: quando o ator sai. Sem ele ou `0`, no fim da tomada.
- `speed`: tempo da tomada por tempo da cinemática, de 0.1 a 10. As animações do ator tocam nessa velocidade também. Sem ele, fica a atual.

A tomada precisa mostrar parte do que gravou e aparecer depois do início da cinemática. Durante a reprodução, a mudança vale na hora.

## Exemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
setCinematicActorTiming(intro, "hero", { at = 2000, start = 3000, stop = 12000, speed = 0.5 })
```

## Veja também

- [getCinematicActors (Cliente)](https://wiki.mymp.gg/pt/getCinematicActors.md): Lista os atores da cinemática: os gravados e os posicionados.
- [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.
- [startCinematicRecording (Cliente)](https://wiki.mymp.gg/pt/startCinematicRecording.md): Começa a gravar um ped, jogador ou veículo como ator da cinemática. Chamada de novo durante a gravação, acrescenta outro ator à mesma gravação.