AutoMovie API
    Preparing search index...
    • Fit one observed orientable disk whose four boundary paths are already identified. Paths include their shared endpoints and contain private vertex ordinals.

      Parameters

      • input: {
            boundaries?: readonly {
                canonicalCurve: IAutoMovieCubicBezierCurve64;
                canonicalKnots: number[];
                corners: [string, string];
                fit: IAutoMovieRecoveryCurveFit;
                id: string;
                knots: number[];
                parameters: number[];
                reversed: boolean;
            }[];
            cornerDegrees: number;
            maxIterations: number;
            maxObservationRows?: number;
            maxPatches: number;
            maxRefinements?: number;
            maxSpans: number;
            name: string;
            physicalGradientLengthMm?: number;
            sides: readonly [
                readonly number[],
                readonly number[],
                readonly number[],
                readonly number[],
            ];
            toleranceMm: number;
            triangles: readonly (readonly [number, number, number])[];
            verticesMm: readonly (readonly [number, number, number])[];
        }
        • Optionalboundaries?: readonly {
              canonicalCurve: IAutoMovieCubicBezierCurve64;
              canonicalKnots: number[];
              corners: [string, string];
              fit: IAutoMovieRecoveryCurveFit;
              id: string;
              knots: number[];
              parameters: number[];
              reversed: boolean;
          }[]

          Oriented fitted boundary results used by this chart; each refers back to a shared canonical coefficient authority.

        • cornerDegrees: number

          Declared turning-angle threshold in degrees for preserving an independent corner tangent.

        • maxIterations: number

          Explicit positive numerical iteration ceiling; exhaustion remains a reported termination, not convergence.

        • OptionalmaxObservationRows?: number

          Optional ceiling on retained area-quadrature observation rows; omission admits at most 250,000 rows per fit.

        • maxPatches: number

          Positive integer ceiling on emitted chart patches; the fitter reports unresolved refinement at the limit.

        • OptionalmaxRefinements?: number

          Optional ceiling on residual-driven refinement rounds; omission permits four rounds after the initial fit.

        • maxSpans: number

          Positive integer ceiling on fitted cubic spans; exhausting it refuses the affected fit.

        • name: string

          Caller-assigned stable semantic identity retained in generated coefficient and observation records.

        • OptionalphysicalGradientLengthMm?: number

          Optional nonnegative millimetre exchange length multiplying physical derivatives; zero or omission disables that objective term.

        • sides: readonly [
              readonly number[],
              readonly number[],
              readonly number[],
              readonly number[],
          ]

          Four ordered chart-boundary vertex paths in the chart owner's fixed side convention; indices address verticesMm.

        • toleranceMm: number

          Positive finite requested positional discrepancy in millimetres; it is not a continuous-surface certificate.

        • triangles: readonly (readonly [number, number, number])[]

          Oriented triangle vertex-index triples addressing the paired position array; indices are not control IDs.

        • verticesMm: readonly (readonly [number, number, number])[]

          Borrowed physical positions in the registered millimetre frame; indices in triangles address this array.

      Returns {
          areaObservation: {
              integratedAreaMm2: number | null;
              maximumRelativeAreaDiscrepancy: number | null;
              quadratureMinimumRows: number;
              qualified: boolean;
              reason: string | null;
              rows: number;
              sourceAreaMm2: number;
          };
          boundary: IAutoMovieRecoveryCurveFit[];
          continuity: "C0-only";
          controlsMm: (readonly [number, number, number])[];
          joint: Omit<IAutoMovieRecoveryChartFit.Result, "controls">;
          leafLayout: {
              bindings: {
                  edge: string;
                  end: number;
                  patch: string;
                  side: 0 | 1 | 2 | 3;
                  start: number;
              }[];
              edges: {
                  axis: 0
                  | 1;
                  controlIds: [number, number, number, number];
                  end: number;
                  id: string;
                  line: number;
                  start: number;
              }[];
              leaves: {
                  bounds: [number, number, number, number];
                  id: string;
                  level: number;
                  root: string;
              }[];
          };
          map: IAutoMovieRecoveryChartMap.Result;
          partition: { u: number[]; v: number[] };
          patches: { controlIds: number[]; id: string }[];
          qualified: boolean;
          refinement: {
              areaRmsMm: (number | null)[];
              attemptedPatches: number[];
              reason: string;
              residualsMm: number[];
              rounds: number;
          };
      }

      • areaObservation: {
            integratedAreaMm2: number | null;
            maximumRelativeAreaDiscrepancy: number | null;
            quadratureMinimumRows: number;
            qualified: boolean;
            reason: string | null;
            rows: number;
            sourceAreaMm2: number;
        }

        Area-quadrature admission and coverage diagnostics, independent of the subsequent coefficient residual.

        • integratedAreaMm2: number | null

          Area represented by accepted quadrature, in square millimetres; null means unavailable.

        • maximumRelativeAreaDiscrepancy: number | null

          Largest dimensionless relative mismatch between source and integrated child area; null means unavailable.

        • quadratureMinimumRows: number

          Minimum row population needed to integrate the complete current chart partition.

        • qualified: boolean

          Whether the owning operation's explicit numerical/topological admission predicates passed; no stronger surface or fidelity claim follows.

        • reason: string | null

          Actual termination or qualification reason; null, where allowed, means no local failure was recorded.

        • rows: number

          Actual quadrature row population retained for the current chart solve.

        • sourceAreaMm2: number

          Area of the supplied physical source triangles, in square millimetres.

      • boundary: IAutoMovieRecoveryCurveFit[]

        One oriented fitted boundary and its normalized pointwise correspondence to the canonical curve.

      • continuity: "C0-only"

        C0-only certifies positional boundary sharing without promising matching transverse derivatives.

      • controlsMm: (readonly [number, number, number])[]

        Bernstein control positions in the common registered millimetre frame, ordered by control registry ID.

      • joint: Omit<IAutoMovieRecoveryChartFit.Result, "controls">

        Joint coefficient-fit diagnostics with coefficient arrays omitted because the enclosing result owns them.

      • leafLayout: {
            bindings: {
                edge: string;
                end: number;
                patch: string;
                side: 0 | 1 | 2 | 3;
                start: number;
            }[];
            edges: {
                axis: 0
                | 1;
                controlIds: [number, number, number, number];
                end: number;
                id: string;
                line: number;
                start: number;
            }[];
            leaves: {
                bounds: [number, number, number, number];
                id: string;
                level: number;
                root: string;
            }[];
        }

        Conforming refined leaf rectangles with shared-edge/control bindings; omission means the tensor partition is used.

        • bindings: { edge: string; end: number; patch: string; side: 0 | 1 | 2 | 3; start: number }[]

          Normalized chart-side intervals bound to their corresponding shared master edges.

        • edges: {
              axis: 0 | 1;
              controlIds: [number, number, number, number];
              end: number;
              id: string;
              line: number;
              start: number;
          }[]

          Undirected edge-incidence registry with the actual incident faces or master-control bindings.

        • leaves: {
              bounds: [number, number, number, number];
              id: string;
              level: number;
              root: string;
          }[]

          Current normalized chart leaves with stable identities and disjoint interiors covering the declared domain.

      • map: IAutoMovieRecoveryChartMap.Result

        Admitted source-observation to normalized-chart parameter map; source topology remains acquisition-only.

      • partition: { u: number[]; v: number[] }

        Increasing normalized u/v break arrays defining the initial tensor patch partition.

        • u: number[]

          Increasing normalized u-axis partition coordinates spanning the declared chart domain.

        • v: number[]

          Increasing normalized v-axis partition coordinates spanning the declared chart domain.

      • patches: { controlIds: number[]; id: string }[]

        Bicubic coefficient patches indexed by the shared control registry, with u varying fastest within each v row.

      • qualified: boolean

        Whether the owning operation's explicit numerical/topological admission predicates passed; no stronger surface or fidelity claim follows.

      • refinement: {
            areaRmsMm: (number | null)[];
            attemptedPatches: number[];
            reason: string;
            residualsMm: number[];
            rounds: number;
        }

        Actual residual-driven refinement history, including incomplete attempts and their reasons.

        • areaRmsMm: (number | null)[]

          Per-round area-weighted position residual RMS in millimetres; null entries mean quadrature was unavailable.

        • attemptedPatches: number[]

          Patch populations attempted in each recorded refinement round.

        • reason: string

          Actual termination or qualification reason; null, where allowed, means no local failure was recorded.

        • residualsMm: number[]

          Per-round maximum observation discrepancies, in millimetres, preserving attempted round order.

        • rounds: number

          Number of refinement rounds actually attempted; zero means the initial layout was sufficient or refused.