# setCinematicAdjustments (Cliente)

> 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.

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

## Sintaxe

```lua
bool setCinematicAdjustments(cinematic cinematic, string slot, table adjustments)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `slot` | `string` | Nome do ator. |
| `adjustments` | `table` | Tabela com as listas `shifts` e `animations`, ambas 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 tempos são da tomada, em ms.

### Deslocamentos (`shifts`)

Cada entrada de `shifts` desloca e gira o ator a partir de um tempo, em ordem de `start`:

- `start`: quando começa (obrigatório).
- `stop`: quando acaba. `0` vale até o fim da tomada.
- `ease`: quanto tempo leva para entrar. `0` entra de uma vez.
- `offset`: um `vec3` no espaço do mundo.
- `turn`: graus, em torno de onde a tomada está em `start`.

### Animações (`animations`)

Cada entrada de `animations` segura uma animação durante um trecho, com o ator parado por baixo, cada uma começando depois que a anterior acaba:

- `start` e `stop`: o trecho (obrigatórios).
- `block` e `name`: a animação (obrigatórios).
- `enter` e `exit`: animações do mesmo bloco para entrar e sair.
- `blend`: ms de mistura, `250` por padrão.
- `loop`: `true` por padrão.

Um veículo não toca animações.

## Exemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
setCinematicAdjustments(intro, "hero", {
    shifts = {
        { start = 0, ease = 500, offset = vec3(0, 2, 0), turn = 15 },
    },
    animations = {
        { start = 4000, stop = 7000, block = "ped", name = "phone_talk" },
    },
})
```

## Veja também

- [getCinematicAdjustments (Cliente)](https://wiki.mymp.gg/pt/getCinematicAdjustments.md): Devolve os deslocamentos e as animações postos sobre a tomada de um ator.
- [getCinematicActorPose (Cliente)](https://wiki.mymp.gg/pt/getCinematicActorPose.md): Devolve onde um ator está num tempo da cinemática. Não precisa de reprodução.
- [setCinematicActorTiming (Cliente)](https://wiki.mymp.gg/pt/setCinematicActorTiming.md): 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.