AutoMovie API
    Preparing search index...

    Interface IAutoMovieCameraIntent

    One frame span's directorial intent for framing, camera movement and lens settings.

    A downstream host can read the lens marks independently of the camera path. The scene camera's fovY remains the geometric field of view.

    interface IAutoMovieCameraIntent {
        focalLength: number | null;
        focus: IAutoMovieVector3 | null;
        focusPull?: { end: number; start: number; to: IAutoMovieVector3 };
        framing: "wide" | "full" | "medium" | "close";
        move: "static" | "follow" | "orbit" | "push-in" | "truck" | "whip";
        start: number;
    }
    Index
    focalLength: number | null

    Positive lens intent in millimetres, full-frame equivalent, or null when the action named none.

    focus: IAutoMovieVector3 | null

    World focus point in metres at the pull's first mark if present, otherwise at shot time 0. A null here means the action named no lens subject.

    focusPull?: { end: number; start: number; to: IAutoMovieVector3 }

    Second focus mark and the timing of both marks, when authored.

    Type Declaration

    • end: number

      Shot-local seconds of the second mark, strictly after the first.

    • start: number

      Shot-local seconds of the first mark, at or after the frame start.

    • to: IAutoMovieVector3

      World focus point in metres at the second mark.

    framing: "wide" | "full" | "medium" | "close"

    Shot size the span asks for.

    move: "static" | "follow" | "orbit" | "push-in" | "truck" | "whip"

    How the camera behaves over the span.

    start: number

    Shot-local start in seconds of the frame span, within the shot.