OptionalcameraDistance in metres passed to every effect sampler for detail selection. Omitted means zero; negative or nonfinite values throw.
Borrowed persisted runtimes, sampled in input order. Every entry is revalidated; returned runtime records are deep copies, so editing them does not alter this array.
Current production, film and compile/edit fingerprints. Malformed identity throws film-effect-input-invalid; disagreement with a runtime throws film-effect-runtime-stale.
Nonnegative safe integer film-frame index, including frames outside an effect's own interval. The underlying sampler then reports that effect inactive rather than dropping the array entry.
Sample film-owned effects at one builder-owned full-rate timeline frame.
Returns one sample per runtime in input order, each taken at the frame's exact boundary second on that runtime's rate, with
cameraDistancein metres passed to the engine sampler (zero when omitted). Every call re-validates each persisted runtime and compares it withidentity; all refusals throwAutoMovieFilmEffectRuntimeError:film-effect-input-invalidfor a malformed identity, a frame that is not a nonnegative safe integer or a negative or non-finite distance,film-effect-runtime-invalidfor a runtime that is not what the materializer writes, andfilm-effect-runtime-stalefor one written under a different production, film, compile or edit identity.