# setCinematicCaptions (Cliente)

> Define los subtítulos que la cinemática dibuja en pantalla durante la reproducción. Reemplaza los subtítulos anteriores.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Cliente
- **Categoría**: Cinemáticas
- **URL**: https://wiki.mymp.gg/es/setCinematicCaptions

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `cinematic` | `cinematic` | La cinemática. |
| `captions` | `table` | Lista de subtítulos, en orden de `time`. |

## Retorno

`true` si se aplicaron. `false` si la tabla no es válida, con un aviso que dice el motivo.

Los tamaños y distancias son en píxeles en una pantalla de 1080 líneas. Cada subtítulo tiene:

- `time`: cuándo aparece, en ms de la cinemática (obligatorio).
- `length`: cuánto dura, en ms, mayor que 0 (obligatorio).
- `text`: el texto (obligatorio).
- `font`: ruta de un `.ttf` en un recurso (obligatorio).
- `size`: de 4 a 400, 36 por defecto.
- `anchor`: `"top-left"`, `"top"`, `"top-right"`, `"left"`, `"center"`, `"right"`, `"bottom-left"`, `"bottom"` (por defecto) o `"bottom-right"`.
- `align`: `"left"`, `"center"` (por defecto) o `"right"`.
- `offsetX` y `offsetY`: desplazamiento desde el ancla.
- `red`, `green` y `blue`: de 0 a 255, blanco por defecto. `opacity`: de 0 a 1, 1 por defecto.
- `fadeIn` y `fadeOut`: ms de fundido.
- `slideIn` y `slideOut`: `"none"` (por defecto), `"left"`, `"right"`, `"top"` o `"bottom"`. `slideDistance`: cuánto se desliza, 60 por defecto.
- `typing`: ms por carácter para escribir el texto. `0` lo muestra todo de una vez.

## Ejemplo

```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 = "¿Dónde están todos?", font = "fonts/subs.ttf", typing = 40 },
})
```

## Ver también

- [getCinematicCaptions (Cliente)](https://wiki.mymp.gg/es/getCinematicCaptions.md): Devuelve los subtítulos de la cinemática.
- [setCinematicAudio (Cliente)](https://wiki.mymp.gg/es/setCinematicAudio.md): Define los sonidos que la cinemática reproduce durante la reproducción. Reemplaza los sonidos anteriores.
- [dxCreateFont (Cliente)](https://wiki.mymp.gg/es/dxCreateFont.md): Crea una fuente a partir de un archivo de fuente del recurso, para las funciones de texto.