AutoMovie API
    Preparing search index...

    Interface IAutoMovieContactReceipt

    One contact episode, shared by geometric measurements and solved performance.

    Times are film seconds and points are world metres. A geometry-only result carries null impulse; the solver supplies completed-step measurements, so a reader must select samples no later than its inspection time. The receipt records what its producer measured rather than certifying continuous contact between samples. Episode aggregation and physical contact sampling own these values; this data type performs no admission.

    interface IAutoMovieContactReceipt {
        a: { body: string; bone: string; material: string; shape: string };
        b: { body: string; bone: string; material: string; shape: string };
        compression: number;
        endSeconds: number;
        id: string;
        impulse: number | null;
        normal: IAutoMovieVector3;
        point: IAutoMovieVector3;
        samples?: {
            appliedImpulse?: { a: number; b: number };
            compression: number;
            duration: number;
            impulse: number;
            normal: IAutoMovieVector3;
            point: IAutoMovieVector3;
            seconds: number;
            separation: number;
        }[];
        seconds: number;
        separation: number;
        source: "geometric"
        | "solver";
    }
    Index
    a: { body: string; bone: string; material: string; shape: string }

    Actor, bone and shape of the first collider.

    Type Declaration

    • body: string

      Physical body identity in the producing scene.

    • bone: string

      Collider's segment bone identity.

    • material: string

      Physical material identity in that body's profile.

    • shape: string

      Collider identity within that segment.

    b: { body: string; bone: string; material: string; shape: string }

    Actor, bone and shape of the second collider.

    Type Declaration

    • body: string

      Physical body identity in the producing scene.

    • bone: string

      Collider's segment bone identity.

    • material: string

      Physical material identity in that body's profile.

    • shape: string

      Collider identity within that segment.

    compression: number

    Peak compression, metres, for the provider's local appearance response.

    endSeconds: number

    Film second of final contact in this episode.

    id: string

    Unique stable episode id.

    impulse: number | null

    Accumulated normal impulse, N s; null for geometry-only measurement.

    Unit world normal directed from a toward b.

    World contact point, metres.

    samples?: {
        appliedImpulse?: { a: number; b: number };
        compression: number;
        duration: number;
        impulse: number;
        normal: IAutoMovieVector3;
        point: IAutoMovieVector3;
        seconds: number;
        separation: number;
    }[]

    Solver-only completed-step measurements; geometric receipts omit these or retain an empty list. An earlier inspection never reads a later impulse.

    Type Declaration

    • OptionalappliedImpulse?: { a: number; b: number }

      Normal impulse actually transferred to each canonical side after explicit response gain and native f32 rounding. Omission identifies a direct native manifold measurement; compliant-solver support requires this authority explicitly.

      • a: number

        Impulse delivered to side a, newton seconds.

      • b: number

        Impulse delivered to side b, newton seconds.

    • compression: number

      This step's surface compression, metres.

    • duration: number

      Step duration used to convert impulse to mean force.

    • impulse: number

      This step's normal impulse, N s.

    • normal: IAutoMovieVector3

      This step's normal from a toward b.

    • point: IAutoMovieVector3

      This step's world application point.

    • seconds: number

      Completed fixed-step second.

    • separation: number

      This step's signed surface separation, metres.

    seconds: number

    Film second of first contact.

    separation: number

    Most negative measured signed separation, metres. Explicit geometric distance queries may return a positive gap; it never qualifies as contact or spawns an impact.

    source: "geometric" | "solver"

    Actual receipt source; geometric receipts never assert a solved impulse.