Log inGet started
Package

stagecraft.module

Newest version

README.md

stagecraft

The film's spine: the clock every moving thing in the demo reads, the schedule the room assembles itself on, and the whole sound mix. It builds no architecture and no props. What it builds is the thirteen audio sources that stand where the film's sounds are made, and the three components that drive the hundred seconds.

Every other slice reaches it for one thing: the film's time.

local t, playing = require("demo.stagecraft").filmTime()

That time comes from cutscene.status(), not from a counter. Nothing in this demo may move on wall time, because two takes have to be the same film.

Exports

NameWhat it is
filmTime(): (number, boolean)The film's current second, and whether it is running. The one clock every scope agrees on.
CLIPSThe seven generated clips, by role: rain, thunder, musicbox, calliope, fall, drip, settle.
clips()Each role resolved to an asset ref, plus the names of any that are missing. Missing clips are reported, never raised.
SOURCESThe mix, as a list: where each source stands, how far it carries, which channel it rides and whether it loops.
EXTRASThe cues that live INSIDE a shot: lightning, the impact, its sub, the lids. Every name here has a handler.
content(root)Builds the Stagecraft group: FilmClock, FaceRig, FilmMix and the Sound group under it.
ensureSources()Stands up every source in SOURCES that is not standing already, and returns how many it added.
oneShot(host, clip, opts)Plays one clip once from a host source at a level and a pitch.
register()Declares the extras and this slice's beat handlers: thunder, the impact, the settles, the lids.
reset()Returns the mix to silence, sets the film's master trim, and restarts every looping bed from the top. Bumps resetGeneration.
status()The film clock, the room's schedule and the mix as they stand right now, in one call.

Components

FilmClock publishes the clock and fires the in-shot cues off it. FaceRig owns when the room stands where, and drives the hall's four mechanisms from four curves. FilmMix carries every source and every channel along an envelope written in film seconds.

What this slice does not own

The endpoints of the room's movement belong to the hall slice; this one owns only the schedule. The camera path belongs to demo.film. The poses, lenses and durations those read belong to demo.constants.