# createCinematic (Cliente)

> Crea un elemento `cinematic`, vacío o a partir de una cinemática guardada. Pertenece al recurso que lo creó y solo existe en este cliente.

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

## Sintaxis

```lua
cinematic|false createCinematic([string source = ""])
```

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `source` | `string` | Los bytes `.cine` que devolvió `getCinematicData`, o la ruta de un archivo `.cine`. Vacío crea una cinemática vacía. *(por defecto: `""`)* |

## Retorno

El elemento `cinematic`, o `false` si los datos están dañados, si el archivo no existe o si no es una cinemática.

Una cinemática guarda las tomas de los actores (peds y vehículos), los vehículos y objetos colocados, los planos de cámara, el clima, la hora, el fundido de pantalla, los sonidos y los subtítulos. Graba con `startCinematicRecording`, edita con las funciones `setCinematic*` y reproduce con `playCinematic`.

## Ejemplo

```lua
local intro = createCinematic("cinematics/intro.cine")
if intro then
    playCinematic(intro)
end
```

## Ver también

- [getCinematicData (Cliente)](https://wiki.mymp.gg/es/getCinematicData.md): Devuelve la cinemática entera como bytes .cine, que createCinematic vuelve a leer.
- [startCinematicRecording (Cliente)](https://wiki.mymp.gg/es/startCinematicRecording.md): Empieza a grabar un ped, jugador o vehículo como actor de la cinemática. Llamada de nuevo durante la grabación, añade otro actor a la misma grabación.
- [playCinematic (Cliente)](https://wiki.mymp.gg/es/playCinematic.md): Reproduce la cinemática: los actores como clones locales, y también la cámara, el clima, la hora, el fundido, los sonidos y los subtítulos.
- [setCinematicCamera (Cliente)](https://wiki.mymp.gg/es/setCinematicCamera.md): Define los planos de cámara que la cinemática dirige durante la reproducción. Reemplaza los planos anteriores.