AutoMovie API
    Preparing search index...

    One scene body's physical profile, authored samples and bounded controller policy.

    targets includes zero and all duration times rate endpoints; translational gains use N/m and N s/m, angular gains N m/rad and N m s/rad. Simulation compute clones this descriptor, supplies documented defaults and admits it before allocating native objects; optional controllers add only the declared physical policy. admitPhysicalBody, admitPhysicalReleasePolicy and admitPhysicalTargets own cross-field validation. Internal actuation requires supportTracking or balance; omitted optional controllers are inactive.

    interface IBody {
        actuation?: "world" | "internal";
        balance?: IAutoMoviePhysicalRecoveryPolicy;
        compensateGravity?: boolean;
        complianceSeconds: number;
        complianceStrength: number;
        handoffLimits?: {
            maximumJointViolation: number;
            maximumLinearError: number;
        };
        handoffSeconds?: number;
        id: string;
        maximumBindings?: number;
        maximumRootForce: number;
        mode: IAutoMoviePerformanceMode;
        profile: IAutoMoviePhysicalProfile;
        releasedQuality?: {
            duringReflex?: boolean;
            internalIterations: number;
            iterations: number;
        };
        releaseOnContact?: {
            earliest: number;
            latest: number;
            otherBody: string;
            otherShapes: string[];
            shapes: string[];
        };
        rootDamping: number;
        rootStiffness: number;
        rootTorque?: { damping: number; maximumTorque: number; stiffness: number };
        selfAvoidance?: { iterations: number; tolerance: number };
        supportTracking?: {
            damping: number;
            iterations?: number;
            maximumForce: number;
            pattern: IAutoMovieFootfallPattern;
            stiffness: number;
            tolerance?: number;
        };
        targets: IAutoMoviePhysicalSimulationInput.ITarget[];
    }
    Index
    actuation?: "world" | "internal"

    World actuators apply external wrenches (default). Internal Cartesian demands map through support/endpoint Jacobians into the existing bounded joint motors, conserving free-body momentum.

    Optional generic support feedback; omission leaves balance to authored tracking.

    compensateGravity?: boolean

    When true, counter weight and downstream gravity moments through existing root-force and joint-torque caps; omitted or false adds no compensation.

    complianceSeconds: number

    Post-contact softening duration, seconds.

    complianceStrength: number

    Tracking fraction while the region is compliant, in [0,1].

    handoffLimits?: { maximumJointViolation: number; maximumLinearError: number }

    Admitted native residuals at return entry. Defaults to contactTolerance metres and 64 native-f32 eps radians. Return never increases the declared envelope; inherited anchor error decays without a pose discontinuity.

    Type Declaration

    • maximumJointViolation: number

      Maximum inherited angular-limit violation, radians.

    • maximumLinearError: number

      Maximum inherited linear constraint error, metres, including fixed pivots and contact penetration beyond admitted material compression.

    handoffSeconds?: number

    Positive seconds for a dynamic subtree to return through one native/display trajectory with continuous relative pose and velocity; defaults to 0.2.

    id: string

    Unique nonblank scene body id, excluding '/' and the reserved id 'floor'.

    maximumBindings?: number

    Maximum collider and point relationships together per sampled target, integer 1..256; defaults to 16. Admission also counts contact, point-bound sides, self-contact, floor and endpoint residual rows.

    maximumRootForce: number

    Root force cap in N, including gravity compensation.

    Physical policy, applied at the scene's body boundary.

    Admitted SI profile.

    releasedQuality?: {
        duringReflex?: boolean;
        internalIterations: number;
        iterations: number;
    }

    Optional minimum native island quality after complete tracking withdrawal; active bodies use the scene settings. Contacts/joints share the island's largest request.

    Type Declaration

    • OptionalduringReflex?: boolean

      Retain this quality while effective root tracking is zero, including balance withdrawal with protective joint effort; defaults to fully released bodies only.

    • internalIterations: number

      Minimum internal constraint sweeps, 1..128.

    • iterations: number

      Minimum native solver iterations, 1..128.

    releaseOnContact?: {
        earliest: number;
        latest: number;
        otherBody: string;
        otherShapes: string[];
        shapes: string[];
    }

    Optional irreversible withdrawal triggered only by an actual positive solver impulse between the selected shape sets in the inclusive window; omission disables this trigger.

    Type Declaration

    • earliest: number

      Inclusive first local simulation second.

    • latest: number

      Inclusive last local simulation second.

    • otherBody: string

      Other scene body.

    • otherShapes: string[]

      Contacting shape ids from the other body's profile.

    • shapes: string[]

      Receiving shape ids from this body's profile.

    rootDamping: number

    Root damping, N s/m.

    rootStiffness: number

    Root positional stiffness, N/m; zero leaves balance/gravity in control.

    rootTorque?: { damping: number; maximumTorque: number; stiffness: number }

    Optional bounded world-orientation motor for the root; omission leaves root orientation without this motor.

    Type Declaration

    • damping: number

      N m s/rad.

    • maximumTorque: number

      N m per world axis.

    • stiffness: number

      N m/rad.

    selfAvoidance?: { iterations: number; tolerance: number }

    Optional geometric target fitting for enabled profile self-contact pairs; omission adds no self-avoidance fit. Admission caps free coordinates at 64 and total shapes at 40.

    Type Declaration

    • iterations: number

      Total bounded geometric updates, 1..64.

    • tolerance: number

      Positive metre residual tolerance.

    supportTracking?: {
        damping: number;
        iterations?: number;
        maximumForce: number;
        pattern: IAutoMovieFootfallPattern;
        stiffness: number;
        tolerance?: number;
    }

    Optional bounded world-point motors for declared support endpoints.

    Type Declaration

    • damping: number

      Endpoint damping, N s/m.

    • Optionaliterations?: number

      Per-cache-interval actual-root support IK iterations, 0..64; defaults to 24. Zero selects force-only endpoint control.

    • maximumForce: number

      Force norm cap at each endpoint, N.

    • pattern: IAutoMovieFootfallPattern

      Actual support owners and their bone-local endpoints.

    • stiffness: number

      Endpoint positional stiffness, N/m.

    • Optionaltolerance?: number

      Metre IK early-out residual; defaults to 0.001.

    Exactly duration*rate+1 frames, including zero.