AutoMovie API
    Preparing search index...

    Interface IAutoMoviePhysicsCache

    Fixed-step display/audit frames and complete state needed to restart the same physical performance.

    Frames use local film seconds at cached rate; checkpoint keys count cached intervals, while ownership and contact samples may carry finer native times. AutoMoviePhysicalSimulation fills this cache and freezes published ordinary records. Methods allocate samples, but public arrays, Maps and snapshot buffers are borrowed producer state. readonly prevents property reassignment, not Map or typed-buffer mutation. Consumers must preserve snapshots and records; frames alone cannot restore native/controller state.

    interface IAutoMoviePhysicsCache {
        balanceCheckpoints: Map<
            number,
            Record<string, IAutoMoviePhysicalRecoveryState>,
        >;
        checkpoints: Map<number, Uint8Array<ArrayBufferLike>>;
        contacts: IAutoMovieContactReceipt[];
        controllerCheckpoints: Map<number, IAutoMoviePhysicalControllerCheckpoint>;
        duration: number;
        frames: IAutoMoviePhysicalFrame[];
        identity: string;
        ownership: IAutoMoviePhysicalOwnershipEvent[];
        protocol: string;
        rate: number;
        recovery: Record<string, IAutoMoviePhysicalRecoveryState>;
        supportWrenches: IAutoMoviePhysicalSupportWrench[];
        at(seconds: number): IAutoMoviePhysicalFrame;
        ownershipAt(
            body: string,
            bone: string,
            seconds: number,
        ): "dynamic" | "return" | "authored";
    }
    Index
    balanceCheckpoints: Map<number, Record<string, IAutoMoviePhysicalRecoveryState>>

    Borrowed recovery-state Map paired with native/controller checkpoints at the same cached indices; preserve its contents for continuation.

    checkpoints: Map<number, Uint8Array<ArrayBufferLike>>

    Borrowed Map from cached interval index to opaque full native-world snapshot bytes. Map entries and typed arrays are not made immutable by object freezing; consumers must not edit them.

    Contact episodes, in start-time order.

    controllerCheckpoints: Map<number, IAutoMoviePhysicalControllerCheckpoint>

    Borrowed controller-state Map paired with native snapshots at the same cached indices; required to restore contacts, compliance, ownership and target plans.

    duration: number

    Complete film seconds.

    Borrowed producer array containing frame zero then every completed cached interval. Completed simulation freezes its ordinary records; direct cache construction can leave it incomplete.

    identity: string

    SHA-256 of solver build and complete sampled inputs.

    Causal native ownership changes; return explicitly uses position-based kinematic authority.

    protocol: string

    Stored with replay data so incompatible checkpoints never resume.

    rate: number

    Fixed steps per second.

    recovery: Record<string, IAutoMoviePhysicalRecoveryState>

    Actual recovery requests, exposed to the authored support-plan consumer.

    Requested/allocated virtual support wrenches at cache instants. These are motor-demand diagnostics; only native contact receipts measure achieved floor force.

    • Return the last causal ownership event for body/bone at or before finite local seconds in [0,duration], including substep transitions. Throws for invalid time or absent matching history.

      Parameters

      • body: string
      • bone: string
      • seconds: number

      Returns "dynamic" | "return" | "authored"