AutoMovie API
    Preparing search index...

    Continue an implicit level along one declared constant physical direction. Seed and target first derivatives use the caller's same parameter domain. Optional second derivatives are propagated analytically for curve consumers. Four level homotopy steps start at the seed's own level. Newton backtracking accepts only decreasing level residuals inside the caller's physical search distance. A singular direction, unsupported query or failed solve throws; the seed is never returned as replacement geometry after a failed solve. This local continuation does not certify a unique root or an embedded chart. Failed solves retain their physical query and bounded ray samples in the error message. Those samples diagnose the selected ray; they do not prove existence or absence of roots between samples or on another ray.

    type IProps = {
        direction: AutoMovieVector3Tuple;
        field: (
            point: AutoMovieVector3Tuple,
        ) => {
            gradient: AutoMovieVector3Tuple;
            hessian: readonly AutoMovieVector3Tuple[];
            value: number;
        };
        maxDistanceMm: number;
        partials: readonly AutoMovieVector3Tuple[];
        point: AutoMovieVector3Tuple;
        seconds?: readonly (readonly AutoMovieVector3Tuple[])[];
        target: {
            partials: readonly number[];
            seconds?: readonly (readonly number[])[];
            value: number;
        };
    }
    Index

    Finite nonzero constant projection direction in the seed frame; normalized internally, so its input magnitude does not set the displacement scale.

    field: (
        point: AutoMovieVector3Tuple,
    ) => {
        gradient: AutoMovieVector3Tuple;
        hessian: readonly AutoMovieVector3Tuple[];
        value: number;
    }

    Read the immutable scalar field, gradient and Hessian at a millimetre query point. Exceptions propagate; failed continuation may query sixteen additional ray intervals for diagnostics before throwing.

    maxDistanceMm: number

    Finite positive absolute displacement bound along the normalized direction, millimetres; trial offsets outside either signed bound are not queried for acceptance.

    partials: readonly AutoMovieVector3Tuple[]

    One or two finite seed partial derivatives in millimetres per caller parameter unit; parameter order matches target.partials and the second-derivative matrices.

    Finite seed point in millimetres in the field's Cartesian frame; the continuation moves only along direction from this seed.

    seconds?: readonly (readonly AutoMovieVector3Tuple[])[]

    Optional square matrix of seed second partials, one row and column per parameter, in millimetres per product of parameter units. Supplying it requires a matching target.seconds matrix.

    target: {
        partials: readonly number[];
        seconds?: readonly (readonly number[])[];
        value: number;
    }

    Desired field level and its derivatives in the same one- or two-parameter domain as the seed jet.

    Type Declaration

    • partials: readonly number[]

      Finite target-level derivatives per caller parameter unit, with length exactly equal to partials.length.

    • Optionalseconds?: readonly (readonly number[])[]

      Finite square target-level second-derivative matrix when seed seconds are supplied; otherwise second-order propagation is omitted.

    • value: number

      Finite target scalar field level, in the field's caller-defined scalar unit; not a physical distance unless the field itself has that unit.