AutoMovie API
    Preparing search index...

    Function advancePhysicalBalance

    • Advance one body's generic recovery controller from actual floor manifolds. Root tracking is withdrawn on unrecoverable support loss. Recovery requests use the shared support-swing interpolator and bounded endpoint motors; their completed placements remain offsets on subsequent authored goals, so the planner and physical support do not snap apart at landing.

      Parameters

      • input: {
            actuation?: Map<string, IAutoMovieVector3>;
            body: string;
            colliders: ReadonlyMap<
                number,
                { body: string; bone: string; material: string; shape: string },
            >;
            contacts: readonly IAutoMovieContactReceipt[];
            dt: number;
            floor: number;
            gravity: number;
            policy: IAutoMoviePhysicalRecoveryPolicy;
            profile: IAutoMoviePhysicalProfile;
            seconds: number;
            segments: ReadonlyMap<string, RigidBody>;
            state: IAutoMoviePhysicalRecoveryState;
            supports?: readonly IAutoMovieCollectPhysicalSupports.ISupport[];
            targets: Readonly<Record<string, IAutoMovieRigidTransform>>;
            unavailable?: readonly string[];
            velocities?: Readonly<Record<string, IAutoMovieVector3>>;
            world: World;
        }
        • Optionalactuation?: Map<string, IAutoMovieVector3>

          Internal Cartesian endpoint demands accumulate into these bounded joint motor demands.

        • body: string

          Scene body identity.

        • colliders: ReadonlyMap<
              number,
              { body: string; bone: string; material: string; shape: string },
          >

          Shape identities, including the explicit floor.

        • contacts: readonly IAutoMovieContactReceipt[]

          Completed-step surface impulses, including compliant support.

        • dt: number

          Fixed seconds per step.

        • floor: number

          Floor height, metres.

        • gravity: number

          Positive downward gravity magnitude.

        • policy: IAutoMoviePhysicalRecoveryPolicy

          Numerical support/motor policy.

        • profile: IAutoMoviePhysicalProfile

          Its actual provider profile.

        • seconds: number

          Current film second.

        • segments: ReadonlyMap<string, RigidBody>

          Current world segment wrappers.

        • state: IAutoMoviePhysicalRecoveryState

          Previous controller state; the caller retains it in checkpoints.

        • Optionalsupports?: readonly IAutoMovieCollectPhysicalSupports.ISupport[]

          Reuse actual constraints and their independently measured load authority.

        • targets: Readonly<Record<string, IAutoMovieRigidTransform>>

          Current authored world placements.

        • Optionalunavailable?: readonly string[]

          Authored reservations prohibit a new recovery swing on these endpoints; actual support contacts still count.

        • Optionalvelocities?: Readonly<Record<string, IAutoMovieVector3>>

          Endpoint world velocities derived from the same sampled authored poses.

        • world: World

          Active solver, read before this step's integration.

      Returns IAutoMovieAdvancePhysicalBalance.IResult