AutoMovie API
    Preparing search index...

    Fit declared support patches to a plane using their actual convex geometry. Keep authored horizontal goals and solve the actual patch height together with those goals, retaining unreachable endpoint/floor residuals. A shared root-drop budget is consumed across passes; cached bodies are never corrected. Non-planted patches preserve their authored clearance, clamped to the floor, so a root-drop correction cannot drive a swinging sole below it.

    type IInput = {
        endpointHeights?: Readonly<Record<string, number>>;
        floor: number;
        goals: Readonly<Record<string, IAutoMovieVector3>>;
        iterations: number;
        maximumRootDrop: number;
        passes: number;
        pattern: IAutoMovieFootfallPattern;
        planted: readonly string[];
        profile: IAutoMoviePhysicalProfile;
        targets: Readonly<Record<string, IAutoMovieRigidTransform>>;
        tolerance: number;
    }
    Index
    endpointHeights?: Readonly<Record<string, number>>

    Explicit world endpoint heights retained alongside floor nonpenetration. Omission preserves the plane-fitting contract.

    floor: number

    World plane height, metres.

    goals: Readonly<Record<string, IAutoMovieVector3>>

    Authored endpoint goals, in world metres.

    iterations: number

    Per-chain IK iterations, 1..64.

    maximumRootDrop: number

    Total permitted root lowering across all passes, metres.

    passes: number

    Bounded outer orientation/height passes, 1..16.

    Arbitrary support chains and patch owners.

    planted: readonly string[]

    Endpoints whose declared patches must touch the plane.

    Admitted fixed-pivot profile.

    targets: Readonly<Record<string, IAutoMovieRigidTransform>>

    Already admitted native motor placements.

    tolerance: number

    Metre endpoint and floor early-out threshold.