OptionalaspectRender aspect (width / height). Defaults to 16 / 9.
Beat id the notes are filed against.
OptionalcontactBody radius in metres a contact point must land within. Defaults to 1.
OptionalgrammarFilm-grammar findings for this shot or its incoming cut, filed before visual-read notes.
Motions the shot's performances reference.
OptionalsampleSamples per second. Defaults to 12.
Staged scene whose nodes and cameras the shot plays over.
The compiled shot: camera, its motion, performances, events, duration.
OptionalsilhouetteSilhouette half-width in metres for the merge check. Defaults to 0.35.
Engine-computed visual-read metrics for one compiled shot, filed as advisory
tier: "visual"review notes after any film-grammar findings passed in. They never fail a gate; they give the review backlog measurable facts about whether the action reads.Every metric reads a performer's world root: its performance's motion sampled at
max(0, t - startOffset)and folded through its staged node. A performance whose node or motion is missing, or that plays no motion, is skipped.sampleRatefrom 0 to the shot's end, a performer whose root leaves the live camera's frustum, behind the near plane, past the far plane, or outside the vertical field of view and theaspect-derived horizontal one, gets one note at the first such time.atan(silhouetteRadius / distance)each, get one note at the first such time; a pair with either root nearer than the near plane at that time is left to the framing metric.hitorcontactevent with a point and a target whose performer's root lies farther thancontactRadiusfrom the point at the event time gets one note.The first two metrics need a live camera with a finite field of view in
(0, 180)degrees andfar > near; without one they are skipped. A root is a point, so a subject whose body is in frame while its root is not is reported; that approximation holds for all three metrics.