Normalized film cue track. Empty input returns an empty array after input admission; output is ordered by start frame then code-unit id and independently owns the materialized streams.
Film frames per second as a positive safe integer or a rational with positive safe-integer terms. Fractional scalar rates are refused. productionFilmEffectFrameRate reduces the ratio; the inner step is one frame's boundary duration.
Current production, film, compile and edit identity, validated before materialization and copied into each runtime for later stale-runtime checks.
OptionalshotShot-owned half-open film-frame intervals used for zone-conflict detection. Omitted means an empty conflict set; each supplied owner and interval is validated.
Borrowed world recipe and zone declarations. Blank or duplicate IDs throw; cues must resolve their zone and that zone's recipe. Stream payloads are cloned.
Materialize normalized film cues into current, deterministic effect streams.
Every cue becomes one
IAutoMovieCompiledFilmEffectin start-frame then code-unit id order, stamped with exactly the four fields ofidentity, the reducedframeRate, its half-open frame interval and a digest of all of them. The inner stream steps one frame at a time, spans the exact boundary seconds of the interval, holds the cue's intensity constant, and takes its seed from the film seed protocol of materializeCompiledEffects.Every refusal throws AutoMovieFilmEffectRuntimeError: a malformed identity, rate, world id, shot interval or cue, or a repeated cue id, is
film-effect-input-invalid; a cue on an unknown zone isfilm-effect-zone-missing; a zone whose recipe is unknown isfilm-effect-recipe-missing; and two film cues, or a film cue and a shot interval, overlapping on one zone arefilm-effect-owner-conflict, naming both cues and the shared frames.