Write a piece of your own
create_pieceMake a piece of the user's own, in one of two ways. from: { film, shot } keeps a scene of a film as it is set (the shot of the library it is, with every choice made on it: settings, elements placed, turned, recoloured, hidden, their entrances and effects, its camera, colours and length; never its words or pictures, which stay in the film); from: { piece } keeps a shot of the library, or one of the user's pieces, under a new name; give it a name. Or recipe: write a piece whole, of the shape get_piece { example: kind } shows: a style, a scene composed of elements (with keys, loops, effects and pulses per element, a camera that hits), a transition or an effect (a fragment shader), an element animation, a text animation, a camera move, a sound written as a score, a 3-D object assembled from our shapes. It is read first (its shape, its shader's words, the pieces it names) and refused with what is wrong; then a quick check draws it (its shader compiles and is not heavy, one meeting or its opening and its life in 16:9, it follows the brand) and the answer says « ready » or what to fix, with a picture. It is kept with the user's pieces (« Mes pièces » on their account; pieces/ on their machine) and used by its id like a piece of the library: add_shot, set_transition, set_element… Rewritten (overwrite: true), the films that use it take the new version. show_piece shows it in a few versions; check_piece passes every gate. The checks draw it in Cutscene's default colours and in another brand (to see that it follows the brand): to see it in the film's, put it in the film and use preview_film. Every word a scene shows is an example the user rewrites: it claims nothing (no figure, price or name).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Instead of recipe or from: a file of another program made scenes of the user's own (a Lottie animation, a composition sent from After Effects by « Send to Cutscene », a timeline .fcpxml, Fusion nodes .setting). Each plays the file's animation with Cutscene's own player in the brand's colours, each text a setting; what is not played (expressions are never run, effects, 3-D…) comes back in left_out, to tell the person | |
| from | No | Keep a scene of a film, or a piece, as it is set (instead of recipe) | |
| name | No | With from: the name the user will find it under, in their language | |
| about | No | With from: a sentence on what it is for | |
| recipe | No | A piece written whole (see get_piece { example: kind }). Leave its id out for a new piece; with overwrite, the id of the user's piece it rewrites | |
| overwrite | No | With recipe: rewrite the user's piece that has this id (its earlier version is kept online) |