# createCinematic (Cliente)

> Cria um elemento `cinematic`, vazio ou a partir de uma cinemática salva. Ele pertence ao recurso que o criou e existe só neste cliente.

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

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `source` | `string` | Os bytes `.cine` que `getCinematicData` devolveu, ou o caminho de um arquivo `.cine`. Vazio cria uma cinemática vazia. *(padrão: `""`)* |

## Retorno

O elemento `cinematic`, ou `false` se os dados estão corrompidos, se o arquivo não existe ou se não é uma cinemática.

Uma cinemática guarda as tomadas dos atores (peds e veículos), os veículos e objetos posicionados, os planos de câmera, o clima, a hora, o fade da tela, os sons e as legendas. Grave com `startCinematicRecording`, edite com as funções `setCinematic*` e reproduza com `playCinematic`.

## Exemplo

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

## Veja também

- [getCinematicData (Cliente)](https://wiki.mymp.gg/pt/getCinematicData.md): Devolve a cinemática inteira como bytes .cine, que createCinematic lê de volta.
- [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.
- [playCinematic (Cliente)](https://wiki.mymp.gg/pt/playCinematic.md): Reproduz a cinemática: os atores com clones locais, e também a câmera, o clima, a hora, o fade, os sons e as legendas.
- [setCinematicCamera (Cliente)](https://wiki.mymp.gg/pt/setCinematicCamera.md): Define os planos de câmera que a cinemática dirige durante a reprodução. Substitui os planos anteriores.