AutoMovie API
    Preparing search index...

    Interface IAutoMoviePhysicalControllerCheckpoint

    Engine controller state captured at one completed fixed step alongside the separate native-world snapshot.

    AutoMoviePhysicalSimulation.run constructs this record from its contact ledger and fitted target plans. Restoring a checkpoint clones it after checkpointPhysicalSimulation establishes an unchanged sampled-input prefix and matching cache protocol. It contains no solver handles, callbacks or native object layouts. A structurally valid record alone does not establish input equivalence or authorize resuming an arbitrary world snapshot.

    interface IAutoMoviePhysicalControllerCheckpoint {
        active: [string, string][];
        balanceTargets?: Record<
            string,
            IAutoMoviePhysicalTargetInterval.IPlan & {
                fromRootDrop: number;
                residuals: Record<string, number>;
                rootDrop: number;
            },
        >;
        contactCount: number;
        contactReleased?: string[];
        contactTargets?: Record<string, IAutoMoviePhysicalTargetInterval.IPlan>;
        episodes: {
            receipt: Omit<IAutoMovieContactReceipt, "samples">;
            sampleCount: number;
        }[];
        handoffs?: Record<string, Record<string, IAutoMoviePhysicalHandoff>>;
        ownershipCount?: number;
        released?: string[];
        softened: [string, number][];
        supportTargets?: Record<string, IAutoMoviePhysicalTargetInterval.IPlan>;
    }
    Index
    active: [string, string][]

    Ordered contact-pair lookup entries [pair key, receipt id] used to reconnect active episodes to the restored ledger.

    balanceTargets?: Record<
        string,
        IAutoMoviePhysicalTargetInterval.IPlan & {
            fromRootDrop: number;
            residuals: Record<string, number>;
            rootDrop: number;
        },
    >

    Recovery target plans by body, detached from mutable binding maps; absent restores no previously fitted recovery plan.

    contactCount: number

    Number of contact episodes in the cache prefix; restoration copies only entries before this index.

    contactReleased?: string[]

    Bodies activated by contact before capture; absent restores an empty contact-release set.

    contactTargets?: Record<string, IAutoMoviePhysicalTargetInterval.IPlan>

    Contact-fitting target plans by body; absent restores no retained contact interval.

    episodes: {
        receipt: Omit<IAutoMovieContactReceipt, "samples">;
        sampleCount: number;
    }[]

    Active episodes retain metadata and their completed sample prefix, so later samples cannot leak into a resumed run.

    Type Declaration

    • receipt: Omit<IAutoMovieContactReceipt, "samples">

      Detached episode metadata at capture; sample arrays remain in the cache's contact ledger.

    • sampleCount: number

      Number of completed samples belonging to this episode at the checkpoint.

    handoffs?: Record<string, Record<string, IAutoMoviePhysicalHandoff>>

    Causal handoff state by body then bone; absent restores no handoffs.

    ownershipCount?: number

    Number of completed native-ownership changes in the cache ledger; absence retains zero entries on restoration.

    released?: string[]

    Bodies whose tracking was released before capture; absent restores an empty release set.

    softened: [string, number][]

    Ordered [body/bone key, release-end seconds] entries for temporarily softened tracking; seconds use the simulation-local clock.

    supportTargets?: Record<string, IAutoMoviePhysicalTargetInterval.IPlan>

    Actual-root floor-support target plans by body; absent restores no retained support interval.