Documentation menu

concepts

Canonical Shot Object

The deep, model-agnostic representation of one directed shot. More detail than any single model needs, on purpose.

Last updated 2026-07-10

What it is

Every shot Cadenza plans is captured as a Canonical Shot Object: the director's full intent, independent of any model's prompt format.

  • Narrative and emotional purpose: why this shot exists in the arc.
  • Camera: lens, movement, angle, plus computed physics (field of view, subject distance, depth of field, motion-blur risk).
  • Framing, blocking, lighting: the visual grammar from the Director Mode.
  • Action beats and performance detail: what happens, externalized physically.
  • Negative constraints: what must not appear.
  • Continuity references: which locked references this shot inherits.
  • Research enrichment: cinematic idiom, edit timeline position, frame-rate feel, depth layers, color intent, artifact risk score.

Why the surplus depth

Different models want different depth. Per-model encoders compress the canonical object into each model's optimal prompt shape, and the surplus is what makes that compression possible without loss of intent. A new model is a new encoder, never a change to the canonical object.

Where you see it

The studio shot list, the plan_director_prompt tool, and public directed pages all render views of the same object. See plan_director_prompt to get it raw, with per-model prompts, for free.

Canonical Shot Object | Cadenza Docs