AutoMovie API
    Preparing search index...

    Function productionFilmFrameForShotTime

    • Map one shot-local review time to its only realized film frame.

      A shot page and a review capture know a shot and a second, not a film frame. The second is first mapped to the source frame that owns it, the largest frame whose exact boundary time is at or before it; film-owned state at that second exists only when the edit realizes that source frame of the shot exactly once, so an absent or repeated occurrence answers null rather than choosing one occurrence. A negative, non-finite or unrepresentable time also answers null, while an inconsistent clock throws AutoMovieFilmEffectRuntimeError with film-effect-input-invalid. The answer depends only on the compiled timeline, never on whether a render has prepared any other runtime.

      Returns number | null