The shot's staged tables and collector.
Gate one positional target of a performance and resolve it to a world point, or report why it cannot be and answer null.
Positional targets are a lookAt, reach or locomote destination, a react source, a point or strike gesture aim, a launch aim, a frame subject or focus, and a coverage subject. They resolve against every staged placement, cameras included, so an actor may look down the lens.
The checks run in this order, each answering null after its violation:
formationsFramed is true, a group naming any formation is refused first, because only a lens frames a mass and every other target asks one body for one point; checking membership first would hide that.bone target's actor must be a staged node with an actor context and a rig carrying that bone; a group must list its nodes as an array with every member staged, and each formation it names must be one this shot compiled. Every id must be a non-blank string.seconds when it answers, and otherwise from the staged placements and opening formation points; a missing or non-finite point is refused naming the id that failed.True for lens subjects that may combine compiled formations; false rejects any nonempty formation list before other target checks.
Human-readable target name used in id/record diagnostics, supplied by the calling gate.
Diagnostic path for this target, such as an action's at field. Child id checks append member/index suffixes to this path.
Shot-local seconds passed unchanged to the live resolver. The caller admits this time; target resolution validates the returned coordinates, not this clock value.
Noun phrase used in positional-resolution diagnostics; independent of the serialized target identity.
Authored value before shape admission. Invalid records, unresolved membership or nonfinite resolved coordinates append a violation and return null; the successful point can alias a callback or staged vector.
The resolved world point in metres, or null after a violation.
Gate one positional target of a performance and resolve it to a world point, or report why it cannot be and answer
null.Positional targets are a
lookAt,reachorlocomotedestination, areactsource, apointorstrikegesture aim, alaunchaim, aframesubject or focus, and a coverage subject. They resolve against every staged placement, cameras included, so an actor may look down the lens.The checks run in this order, each answering
nullafter its violation:formationsFramedis true, a group naming any formation is refused first, because only a lens frames a mass and every other target asks one body for one point; checking membership first would hide that.bonetarget's actor must be a staged node with an actor context and a rig carrying that bone; agroupmust list its nodes as an array with every member staged, and each formation it names must be one this shot compiled. Every id must be a non-blank string.secondswhen it answers, and otherwise from the staged placements and opening formation points; a missing or non-finite point is refused naming the id that failed.