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.
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.
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.
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.
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.
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.