AutoMovie API
    Preparing search index...

    Sample FK and compare configured foot points and valid capsule endpoints to scalar/height-source ground minus tolerance.

    type IProps = {
        capsules?: readonly IAutoMovieCapsuleProxy[];
        footBones?: readonly AutoMovieHumanoidBone[];
        groundY?: number | ((x: number, z: number) => number);
        jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>;
        motion: IAutoMovieMotion;
        path?: string;
        physicsIntent?: string;
        restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>;
        sampleRate?: number;
        skeleton: IAutoMovieSkeleton;
        tolerance?: number;
    }
    Index
    capsules?: readonly IAutoMovieCapsuleProxy[]

    Whole-body capsule proxies swept against the ground (#1185): each is a from → to bone segment with a radius, and its lowest surface point (min(from.y, to.y) − radius, sampled per endpoint against a heightfield) must stay above the ground, so a hand, hip, elbow, or prop clipping through the floor is no longer invisible the way the foot-point check leaves it. A capsule on a missing or detached bone is a type error, not a silent skip (the totality contract the point check does not carry). Omit to check only footBones.

    footBones?: readonly AutoMovieHumanoidBone[]

    Bones treated as ground-contact points. Defaults to both humanoid feet.

    groundY?: number | ((x: number, z: number) => number)

    Ground height: plane scalar or (x, z) → y source. Defaults to 0.

    jointAxes?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieJointAxes>>

    Optional clinical-axis remap for rigs authored in semantic axes.

    Motion clip to sample.

    path?: string

    JSON path of the motion being checked. Defaults to $input.

    physicsIntent?: string

    Marker that opts the clip out of the ground-contact expectation: a deliberate pass-through (a phasing ghost, a stylized float) sets this and the matching warnings are suppressed.

    restFrames?: Partial<Record<AutoMovieHumanoidBone, IAutoMovieRestFrame>>

    Optional rest-frame remap for clinical authoring.

    sampleRate?: number

    Samples per second used by the validator. Defaults to 24.

    Skeleton used for forward kinematics.

    tolerance?: number

    Allowed penetration depth before violation. Defaults to 0.