AutoMovie API
    Preparing search index...

    Type Alias IAutoMovieGeometryActorReader

    Geometry-query operations over a borrowed map of compiled shots, retained for the reader's lifetime.

    Actor IDs resolve scene-node IDs. With no shot ID, an actor must occur in exactly one compiled shot; missing actors/models and ambiguous actors throw. Actor sampling requires finite shot-local seconds in [0, shot.duration]. Performance motion starts at max(0, time - startOffset); node object channels use shot time. Samples are recomputed from current records and no pose cache is retained. Returned borrowed records and vectors must be treated as read-only even where the structural types permit mutation.

    type IAutoMovieGeometryActorReader = {
        find: (actor: string, shot?: string) => ICompiledActor;
        pose: (
            actor: string,
            shot: string | undefined,
            time: number,
        ) => Record<string, number | string | boolean>;
        position: (
            compiled: IAutoMovieCompiledShotSource,
            actor: string,
            time: number,
        ) => IAutoMovieVector3;
        selector: (
            selector: IAutoMovieGeometrySelector,
            world: Pick<IAutoMovieWorldDesign, "landmarks"> | null,
            options?: { shot?: string; time?: number },
        ) => IAutoMovieVector3;
        spatial: (
            compiled: IAutoMovieCompiledShotSource,
            actor: string,
            time: number,
            skeleton: IAutoMovieSkeleton | null,
        ) => ISpatialSample;
    }
    Index
    find: (actor: string, shot?: string) => ICompiledActor

    Return a fresh wrapper borrowing the matching shot, node and resident model. An omitted shot searches every supplied shot; absent or multi-shot matches and missing node models throw. No sample time is read.

    pose: (
        actor: string,
        shot: string | undefined,
        time: number,
    ) => Record<string, number | string | boolean>

    Return a fresh scalar summary at finite shot-local seconds in [0, duration]: shot/actor IDs, held (selected performance or node motion is null), world-metre rootX/rootY/rootZ, and the sampled pose's jointCount. An omitted shot requires a unique actor across the map; missing motion throws.

    position: (
        compiled: IAutoMovieCompiledShotSource,
        actor: string,
        time: number,
    ) => IAutoMovieVector3

    Resolve the actor and model within this compiled shot, then return its world root point in metres at the supplied shot-local seconds. Node TRS transforms pose-root translation; the result can alias node translation when no pose root is present.

    selector: (
        selector: IAutoMovieGeometrySelector,
        world: Pick<IAutoMovieWorldDesign, "landmarks"> | null,
        options?: { shot?: string; time?: number },
    ) => IAutoMovieVector3

    Resolve a world-space point in metres. Point and landmark selectors return borrowed vectors and ignore sampling options; a missing landmark throws. Actor/bone results are sampled, and an absent rig or unresolved bone throws. Actor-root results may also alias a node translation.

    spatial: (
        compiled: IAutoMovieCompiledShotSource,
        actor: string,
        time: number,
        skeleton: IAutoMovieSkeleton | null,
    ) => ISpatialSample

    Sample a known node in the supplied compiled shot at finite shot-local seconds in [0, duration]. The caller must first resolve the actor and provide its model's skeleton, or null for an unrigged model; unlike find, this entry does not validate node membership. Missing referenced motion throws. Returns a shallow sample with borrowed nested records.