AutoMovie API
    Preparing search index...

    Interface IAutoMovieRetargetContactProps

    Configure source-contact preservation during humanoid retargeting; omitted fields enable the pass with source-rest-floor stance detection and no declared hand contacts.

    interface IAutoMovieRetargetContactProps {
        enabled?: boolean;
        groundY?: number | ((x: number, z: number) => number);
        hands?: readonly IAutoMovieRetargetHandContact[];
        tolerance?: number;
    }
    Index
    enabled?: boolean

    Run contact correction. Defaults to true; false keeps copied clinical angles and scaled root motion.

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

    Ground height for source stance detection: a plane scalar or an (x, z) → y source. Defaults to the source rig's own rest floor (the lowest world Y of its zero pose), so a rig authored with its feet above the origin still detects stance instead of never touching down.

    Hand contacts to preserve. Defaults to none.

    tolerance?: number

    Contact tolerance above the ground counted as stance, in source model units. Defaults to 0.02, the same band plantStanceFeet and validateGroundContact use. It doubles as the residual budget: a pinned effector that ends further than tolerance * rootScale from its contact is reported as a plausibility warning.