Director
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. -->
Director
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this component provides and who consumes it, then delete both comment lines. -->TODO: describe this component.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2FURROW — the director. The film's single entry point and its only clock. Add this to one entity in the scene and the whole 181-second film runs from shot 1 to the end, deterministically, as soon as the world enters play. There is nothing else to start. What it does, once per play frame, in this order: 1. advances filmClock by a FIXED 1/24 s step 2. points the shot on screen at its subject, if that shot tracks one 3. ticks the cutscene runtime by the same step, which poses the camera 4. keeps the "ears" on the shot camera so the world is heard from the lens 5. publishes the film time and the shot number as entity attributes Every other slice reads `filmClock.now()` in its own component update and poses itself for that instant. Nobody else advances anything. Determinism: because the step is stated rather than measured, the film is the same 181 seconds every run regardless of frame rate. Run it twice, get the same film. That is what lets the Film phase record in one pass. IT ONLY RUNS IN PLAY. A cutscene stage takes the camera and lays a fade over every view in the world, and this world has five people authoring in it. In edit the clock sits at `startAt`, the stage is not stood up, and nobody's viewport is taken. Enter play to watch the film; leave play to keep working. To run it again: leave play and re-enter. To start from the middle, set `startAt` before entering play. Owner: the CAMERA & TIMELINE slice.
sweepStage( ) → void
Take down any cutscene stage left standing by a previous playback.
isTheDirector( ) → boolean
True when this component is the one that runs the film. A scene that ends up with two directors has two runtimes fighting for one camera and each sweeping the other's stage away; the lower id wins and the other says so.
publish(t: number) → void
| arg | type | description |
|---|---|---|
| t | number |
arm( ) → void
Stand the film up: the runtime, the stage, the camera. Called on the first play frame, never in edit.
disarm( ) → void
Give the camera, the overlay and the viewport back.
awake( ) → void
aim(t: number) → void
Point the shot on screen at its live subject. The look anchor is rewritten in place with a world position rather than handed the entity, so a subject that goes away leaves the last good frame instead of a shot whose camera stops being placed at all.
| arg | type | description |
|---|---|---|
| t | number |
update(_dt: ?) → void
| arg | type | description |
|---|---|---|
| _dt | ? |
onDestroy( ) → void
Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.