The format of a film

A film is a JSON file, .cutscene.json: the same thing the editor keeps in your browser and the connector writes in your folder. It holds only the names of pieces and their settings, never a picture or a sound: pictures stay beside it.

Its fields

v
The version of the format.
id
The film's identifier.
title
Its title.
format
16:9, 9:16, 4:5 or 1:1.
fps
Frames per second on export: 30 or 60.
bpm
The tempo the scenes are set on, in beats per minute.
lang
The language of the examples the scenes show: fr or en.
brand
The brand: name, colours, typefaces, corners, logo.
shots
The scenes in order: each names a piece of the library, its settings, its texts, its length.
seams
The transitions, one between each scene and the next.
audio
The music and the sounds.
look
What is laid over the whole picture (grain, vignette…).
custom
The pieces somebody wrote, which the film carries to open anywhere.

A file is checked when it is opened: an unknown field or a value out of bounds is refused with its path.

For an assistant, get_film gives the film in a few lines rather than the whole file.

Opening a file in the editor: “My films”, “Open a film saved in a file”.