# setCinematicCaptions (Cliente)

> Define as legendas que a cinemática desenha na tela durante a reprodução. Substitui as legendas anteriores.

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

## Sintaxe

```lua
bool setCinematicCaptions(cinematic cinematic, table captions)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `cinematic` | `cinematic` | A cinemática. |
| `captions` | `table` | Lista de legendas, em ordem de `time`. |

## Retorno

`true` se aplicou. `false` se a tabela é inválida, com um aviso dizendo o motivo.

Os tamanhos e distâncias são em pixels numa tela de 1080 linhas. Cada legenda tem:

- `time`: quando aparece, em ms da cinemática (obrigatório).
- `length`: quanto dura, em ms, acima de 0 (obrigatório).
- `text`: o texto (obrigatório).
- `font`: caminho de um `.ttf` num recurso (obrigatório).
- `size`: de 4 a 400, 36 por padrão.
- `anchor`: `"top-left"`, `"top"`, `"top-right"`, `"left"`, `"center"`, `"right"`, `"bottom-left"`, `"bottom"` (padrão) ou `"bottom-right"`.
- `align`: `"left"`, `"center"` (padrão) ou `"right"`.
- `offsetX` e `offsetY`: deslocamento a partir da âncora.
- `red`, `green` e `blue`: de 0 a 255, branco por padrão. `opacity`: de 0 a 1, 1 por padrão.
- `fadeIn` e `fadeOut`: ms de fade.
- `slideIn` e `slideOut`: `"none"` (padrão), `"left"`, `"right"`, `"top"` ou `"bottom"`. `slideDistance`: quanto desliza, 60 por padrão.
- `typing`: ms por caractere para digitar o texto. `0` mostra tudo de uma vez.

## Exemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
setCinematicCaptions(intro, {
    { time = 500, length = 4000, text = "Los Santos, 1992", font = "fonts/title.ttf", size = 48, anchor = "top", offsetY = 80, fadeIn = 500, fadeOut = 500 },
    { time = 3000, length = 2500, text = "Cadê todo mundo?", font = "fonts/subs.ttf", typing = 40 },
})
```

## Veja também

- [getCinematicCaptions (Cliente)](https://wiki.mymp.gg/pt/getCinematicCaptions.md): Devolve as legendas da cinemática.
- [setCinematicAudio (Cliente)](https://wiki.mymp.gg/pt/setCinematicAudio.md): Define os sons que a cinemática toca durante a reprodução. Substitui os sons anteriores.
- [dxCreateFont (Cliente)](https://wiki.mymp.gg/pt/dxCreateFont.md): Cria uma fonte a partir de um arquivo de fonte do recurso, para usar nas funções de texto.