OptionalblockingThe beat's validated blocking. Supplying it arms the coherence gate and the coverage takes.
OptionalcameraCompiler-owned geometry revision and inspection clock. Required once a take's camera declares a physical envelope; a camera without one is unaffected when it is omitted.
OptionalformationThe shot's compact formation cues, so a framed unit is measured where its cue has put it; omitted, every formation is framed at rest.
OptionalformationsCompiled compact formations present in this shot, so a camera can frame a mass. A group naming a formation this list lacks is a violation.
OptionalframeDelivery raster for the horizontal half of the framing fit. Omitted, or with a non-positive side, a wide subject is fitted to a square frame, which stands back far enough for any raster of that height.
Delivery height in pixels used as the aspect-ratio denominator; the same non-positive-side fallback applies.
Delivery width in pixels used only through width/height. A side that is not greater than zero selects the square-frame fallback; finite positive dimensions are the caller's premise.
OptionalgaitsThe gait names each actor supplies; a locomote naming another gait is a
violation. Omitted, or undefined for a node, skips the check.
OptionalhasActor-registry membership; omitted, a bone target's actor is not checked against a registry.
OptionaljointPer-node joint axes the renderer uses, so ground planting and attachment baking read the rig through one basis. Omitted, both use their defaults.
OptionallightClips moving the staged lights over this shot's clock, carried onto
shot.lightMotions after each track is checked to address a staged
light. Omitted, the shot carries no such field.
OptionalmodelsCompiler-owned models for the staged nodes, used to measure what a camera frames. A rig's joint span is not the figure's height, so framing from the rig alone crops a head; omitted, the rig span is the fallback.
OptionalobjectClips the source authored over non-performing scene nodes, such as a
door's panel or a prop's hinge, carried onto shot.objectMotions after the
baked ones once gateAuthoredObjectMotions admits them.
The beat's performance: beat id, duration, draft and revise pass.
OptionalpolygonPolygon body changes keyed by staged node and rig bone, timed in source-shot seconds.
OptionalpracticalPractical lights bound to staged prop emitters. Compiled from the final object clips, using the corresponding prop model in models, and appended to lightMotions. Omit when no practical source follows a prop.
OptionalpracticalShot-local material changes on placed prop parts. Nonempty input requires the corresponding generated rigid models in models. Omit for the staged appearance alone.
OptionalpreviousPrior verified beat state, passed to every synthesizer call. The caller
restages staged from it beforehand, as compileDefinedShot does.
OptionalpropsThe shot's prop registry, whose articulation lowers the joints an authored object clip may drive and bounds their travel.
OptionalrestPer-node rest frames the renderer uses, so planting and attachTo clips
read the visible pose rather than raw rig-space forward kinematics.
The script whose beats the performance may realize.
OptionalshotRegistered source identity for direct code authoring; omitted, the shot id
is shot:<beat>.
Rig lookup by node id; null for a node with no skeleton, whose clip skips the range-of-motion gate and whose subject is measured without a rig span.
The validated stage result, the one coordinate authority for the shot.
Synchronous action/actor synthesizer. performShot memoizes each action object and actor pair, including null, and passes previous through; null contributes no motion. Exceptions propagate and input actions must remain stable.
OptionaltargetLive resolver for targets whose point changes during the shot; its null
falls back to the staged placement. Positions are world metres at
shot-local seconds.
The inputs of performShot: the script, the staged world and the beat's performance, the synthesizer and rig lookups that realize it, and the optional context that sharpens framing, gating and coupling.
Every optional field states what omitting it does; none changes the shot of a caller that omits it beyond what that field documents.