AutoMovie API
    Preparing search index...

    Interface IAutoMovieNormalizedGrammarShot

    One shot observation after normalizeGrammarShot has validated it and put every order-free collection into a canonical order, the form the film-grammar read inspects.

    The camera samples, duration, primary subject and declared size are the observation's own values. The subjects are sorted by id and indexed once, and the action axis is stored with its endpoints sorted, so neither the order a producer listed subjects in nor the order it named the axis can change a finding.

    interface IAutoMovieNormalizedGrammarShot {
        actionAxis: readonly [string, string] | null;
        camera: {
            end: IAutoMovieGrammarCameraObservation;
            start: IAutoMovieGrammarCameraObservation;
        };
        declaredShotSize: "wide"
        | "full"
        | "medium"
        | "close"
        | null;
        duration: number;
        id: string;
        primarySubject: string | null;
        styleIntent: AutoMovieGrammarStyleIntent[];
        subjectById: ReadonlyMap<string, IAutoMovieGrammarSubjectObservation>;
        subjects: IAutoMovieGrammarSubjectObservation[];
    }

    Hierarchy

    Index
    actionAxis: readonly [string, string] | null

    The line of action with its two distinct, observed endpoints sorted by id, or null when the shot states none.

    Resolved camera at both edited shot boundaries.

    Type Declaration

    declaredShotSize: "wide" | "full" | "medium" | "close" | null

    The framing the shot claims, compared with the size measured at both boundaries, or null when no single claim covers the edited span; null disables the shot-size check.

    duration: number

    Edited duration in seconds; finite and positive.

    id: string

    Shot id, non-blank and unique in the input.

    primarySubject: string | null

    Id of the principal subject, one of subjects. The shot-size, jump-cut, eyeline and screen-direction checks and the displacement half of the re-establishing check measure it; null disables them for this shot.

    Declared exceptions in declaration order, each once; empty when absent.

    subjectById: ReadonlyMap<string, IAutoMovieGrammarSubjectObservation>

    The same subjects keyed by their unique id.

    The observed subjects, sorted by id in code-unit order.