# Reveal grammar ## Why the format works A held photo with a loading bar makes the viewer wait for something. The white flash is the payoff, and the cut hides the swap from a real photo to a made one. The "after" has to answer the wait fast: it is the same place and the same subject with one clear change, moving from the first frame. People rewatch it to catch the cut, and the sound they add makes the drop feel earned. The loading transition keeps coming back in different costumes: pets, rooms, products, outfits. Present it as a loading reveal of whatever the user has, not as one season's costume. ## The 7-second timeline | Time | What the viewer sees | Made by | |---|---|---| | 0.00 to 1.85 s | The before photo, still, a little darker. A dark panel with "LOADING." (one, two, then three dots) and a bar that crawls to 93% | ffmpeg and the local overlay | | 1.85 to 2.00 s | The bar jumps to full; the picture ramps to white over two frames | ffmpeg | | 2.00 s (frame 48) | A fully white frame: **the beat** | ffmpeg | | 2.00 to 2.25 s | The white clears into the after picture | ffmpeg | | 2.00 to 7.00 s | The after clip in motion, one continuous shot | Kling 3 pro, from the after still | Hold time is 1.5 to 3 s and the after is 3.5 to 6.5 s, so the total stays between 6 and 8 s. Longer holds lose people before the flash. ## The loading screen - Drawn locally: a dark rounded panel, the label in a pixel font and a bar that fills. No model draws any of it, so the spelling is exact. - The label is up to 16 characters: letters, numbers, space and `. , ! ? - : % '`. It is drawn in capitals. "loading" is the default; the dots animate unless `--no-dots`. - The panel sits at 66% of the height by default (`--ui-y`, 0.45 to 0.72). It must stay clear of the bottom 20%, where the app puts its caption and buttons; the script refuses a panel that reaches into it. Move it if it covers the subject's face or the thing the viewer must see. - The bar colour is white; `--accent #hex` changes the fill. Keep it light enough to read against the dark track. - The before photo is dimmed by 8% (`--dim`) so the panel reads. It does not move: a frozen frame is the point. ## The flash and the beat - The two frames before the beat ramp to white and the beat frame is fully white. The white then clears over 0.25 s (`--flash`, 0.1 to 0.6). - The beat is the first fully white frame, at the hold time (frame 48 at 24 fps for a 2 s hold). The script prints it, writes it to `reveal.mp4.edl.json` and sets an MP4 chapter called "Beat" at that time. - This is a hard cut under the flash. Do not add a dissolve or a morph; the flash is the transition. ## Adding the sound The file has no audio track. Meleon does not make, ship or copy any sound. The user picks one from the app's own library, so its licence covers that app. 1. Open the reveal in the app's editor and add the sound. 2. Find the sound's drop, its first loud beat or the moment it swells. Move the sound so that moment lands on the first white frame, at the printed beat time (2.000 s for the default). 3. If the drop is early in the sound, start the sound partway in, so its drop falls on the beat. If the app shows beat markers, snap the flash to one. 4. Play it twice with the sound on and nudge by a frame or two until the flash and the drop feel like one hit. ## Safe zones - Keep the subject's face and the action clear of the top 12% and the bottom 20%, and away from the right edge, where the app's buttons sit. - The before and after share one framing, because the after still is made from the same 9:16 crop. If the subject moves between them, the flash looks like a mistake: re-roll the still. ## The reveal menu | Reveal | Kinds | What changes | Best for | Watch for | |---|---|---|---|---| | `costume` | pet, product, person | The subject wears or shows a new look, in the same pose | A pet in a cape and goggles, a product in a seasonal wrap, a person's styling | The costume covering eyes or nose, a pet that looks uncomfortable, markings that drift | | `room` | room | The same room, camera and layout, redone in a new style | Interior designers, renovation and staging posts | Walls and windows moving between the two frames; people or pets appearing | | `sketch` | sketch | The drawing becomes a real photographed thing | Product ideas, children's-book-style concepts, character art | The real thing keeping the drawing's shape and colours; the paper vanishing cleanly | | `unbox` | product | A closed box becomes the open box with the product in it | Product launches | Logos and labels (plain by default); the product matching the photo | | `custom` | any | Anything you can say in one sentence | The user's own idea | One change only; fill every `FILL:` field | None of these has made a passing sample yet unless `assets/reveals.json` says `tested: true`. Only `costume` (pet) has made a sample so far; test any other reveal with one Kling final before promising the look.