AutoMovie API
    Preparing search index...

    Generate an indexed surface from saved physical polygon identities and P/Q paths. P emits (P_i,Q_j,P_next); Q emits (Q_next,P_i,Q_j). Positive XZ rings and increasing Y stations give outward winding on an ordinary exterior slab. This operation validates the path, not its optimization or geometric embedding. Finite positive-area faces survive incidence warnings; collapsed faces are counted.

    type IResult = {
        construction: { id: string; points: [number, number, number][] }[];
        diagnostics: string[];
        mesh: IAutoMovieMesh;
        pairs: {
            areaMm2: number;
            diagnostics: string[];
            firstTriangle: number;
            id: string;
            objectiveDiscrepancyMm2: number;
            omittedTriangles: number;
            triangles: number;
        }[];
    }
    Index
    construction: { id: string; points: [number, number, number][] }[]

    Saved polygon boundaries converted to metres, each closed by repeating its first point at the end.

    Type Declaration

    • id: string

      Original saved polygon identity.

    • points: [number, number, number][]

      World-metre points in original ring order followed by the first point again; the caller owns the returned arrays.

    diagnostics: string[]

    Whole-mesh normal and oriented-incidence qualifications, including the explicit unproved simplicity, embedding and optimizer limitations.

    New indexed mesh in metres with physical polygon-vertex identities; unresolved accumulated normals remain zero and are diagnosed.

    pairs: {
        areaMm2: number;
        diagnostics: string[];
        firstTriangle: number;
        id: string;
        objectiveDiscrepancyMm2: number;
        omittedTriangles: number;
        triangles: number;
    }[]

    One emission report per requested pair in input order, including pairs whose proposed triangles were all omitted.

    Type Declaration

    • areaMm2: number

      Sum of retained triangle areas in square millimetres, measured from the published metre positions.

    • diagnostics: string[]

      Pair-local repeated-face or omitted-triangle reports; warnings do not discard otherwise finite positive-area faces.

    • firstTriangle: number

      First retained triangle ordinal in the returned mesh for this pair, measured before emitting the pair.

    • id: string

      Original pair identity.

    • objectiveDiscrepancyMm2: number

      Absolute difference between measured retained area and objectiveAreaMm2, in square millimetres.

    • omittedTriangles: number

      Number of proposed triangles whose cross-product magnitude was zero or nonfinite.

    • triangles: number

      Number of finite positive-area triangles retained for this pair.