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 cameraDistance in metres
passed to the engine sampler (zero when omitted). Every call re-validates
each persisted runtime and compares it with identity; all refusals throw
AutoMovieFilmEffectRuntimeError: film-effect-input-invalid for a malformed
identity, a frame that is not a nonnegative safe integer or a negative or
non-finite distance, film-effect-runtime-invalid for a runtime that is not
what the materializer writes, and film-effect-runtime-stale for one written
under a different production, film, compile or edit identity.
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.