AutoMovie API
    Preparing search index...

    Function compilePerformShotCameras

    • Compile the camera fields of a performed shot: the live camera's move, its per-span intent, one alternate take per coverage job, and the clearance reports.

      The live camera's frame moves, already sorted by start, compile through compileCameraMove into the clip cam:<scope>; with no move the camera is locked off and the clip is null. Each move's intent carries its framing, move, focal length and focus, ordinary focus resolved to the opening point the input gate accepted. An authored focus pull resolves two lens marks after actor and object motion are compiled. A downstream host reads the intent independently of the camera path. Each coverage job plays its one framing across the whole beat from its own staged camera, as the clip cam:<scope>:<camera>, so a host can cut to the angle at any instant, with no focus or focal length invented for it. Every subject is measured by one createPerformShotSubjectFramer, so hero and coverage frame the same subject. compileCameraClearanceReports then reports any take whose physical envelope is obstructed into the context's collector.

      Parameters

      • context: IAutoMovieEnginePerformShotGateContext

        The shot's staged tables and collector.

      • props: IAutoMovieCompilePerformShotCameras.IProps

        Finalized shot data borrowed by compilePerformShotCameras to produce hero movement, lens intent, alternate takes and clearance reports.

        The live camera's frame moves, already sorted by start, compile through compileCameraMove into the clip cam:<scope>; with no move the camera is locked off and the clip is null. Each move's intent carries its framing, move, focal length and focus, the focus resolved to the world point the input gate accepted; the solve never reads the intent, a render host does. Each coverage job plays its one framing across the whole beat from its own staged camera, as the clip cam:<scope>:<camera>, so a host can cut to the angle at any instant, with no focus or focal length invented for it. Every subject is measured by one createPerformShotSubjectFramer, so hero and coverage frame the same subject. compileCameraClearanceReports then reports any take whose physical envelope is obstructed into the context's collector.

        • aspect: number | undefined

          Delivered width/height ratio; undefined uses the camera compiler's square fit, as do non-positive/non-finite values at that lower layer.

        • coverageJobs: readonly IAutoMoviePerformShotCoverageJob[]

          Admitted alternate camera jobs in authored order, each covering the entire shot. Empty requests no alternate takes.

        • formationMotions: readonly IAutoMovieFormationMotion[]

          Compact formation cues on the shot clock, used when measuring and following group subjects; empty keeps groups at their opening placement.

        • frames: readonly IAutoMoviePerformShotFrameJob[]

          Admitted hero moves sorted by action.start in shot-local seconds; empty leaves the camera locked off and intent empty.

        • liveCamera: string

          Id of the staged camera elected by gatePerformShotCamera; this compiler assumes the lookup succeeds.

        • models: readonly IAutoMovieModel[] | undefined

          Portable staged model catalogue. Undefined behaves as an empty catalogue: framing may use rig/default bounds, while envelope clearance refuses unmeasurable staged obstacles.

        • motions: Record<string, IAutoMovieMotion>

          Final actor motions by node id, read without mutation after coupling; absent entries contribute no actor motion.

        • objectMotions: readonly IAutoMovieClip[]

          Final object clips in producer/channel-authority order, sampled on the shot clock for framing and clearance.

        • rotations: ReadonlyMap<string, IAutoMovieQuaternion>

          Staged node world-facing quaternions, used to place actor root movement; a missing facing prevents the actor-motion following branch.

        • runtime: IAutoMovieCameraClearanceRuntime | undefined

          Builder-owned geometry revision and clearance clock; required only when a selected camera declares an envelope.

        • scope: string

          Clip-id suffix, normally the shot id or otherwise beat id; used verbatim in cam: and coverage ids.

      Returns Pick<
          IAutoMovieShot,
          "cameraMotion"
          | "cameraIntent"
          | "coverage"
          | "cameraClearance",
      >

      The shot's camera fields.