# camera.shots The thirteen set-ups of *Standing Ovation*, as data — where the lens stands, what it is aimed at, how it moves across the shot, and which lens it is on. Consumed by `camera.filmCamera`, which evaluates it every rendered frame off the film clock and writes the FilmCamera's transform and fov. Nothing else writes that camera. ## What an entry holds | key | meaning | |-----|---------| | `eye` | world points. One = a locked-off camera. Two or more = keys the lens moves through. | | `look` | world points, the same shape. What the lens is aimed at. | | `lookRel` | an aim offset carried along with the lens, instead of `look` — a tracking shot that keeps looking the same way relative to itself. | | `lookEntity` | a leaf another slice owns. If it is in the world the aim follows it; if it is not, the aim falls back to `look`, so a shot never stops framing. | | `ease` | `"smooth"` (default) or `"linear"`. | | `breathe` | metres of deterministic drift on a locked-off lens, a pure function of the shot's own local time. A held camera, not a rendered still. | The lens is never restated here: `Shots.fov(n)` reads `Film.SHOTS[n].fov`. ## The bookend Shot 1 and shot 13 are the same station, the same aim and the same lens. They do not hold two copies of the numbers — both entries carry `Shots.STATION_I14` and `Shots.AIM_I14` **by reference**, and `Shots.check()` asserts that with `rawequal` so the two ends of the film cannot drift apart: ```lua require("camera.shots").check() --> { bookendSharesStation = true, bookendSharesAim = true, -- bookendSharesLens = true, millimetres = 0, setups = 13 } ``` ## Calls ```lua local Shots = require("camera.shots") Shots.eval(n, u) --> ex, ey, ez, lx, ly, lz -- u is 0..1 across shot n Shots.station(n) --> x, y, z -- the undrifted station Shots.fov(n) --> vertical degrees Shots.check() --> the bookend report above ``` ## Points other slices may want `Shots.STATION_I14` / `Shots.AIM_I14` (the bookend), `Shots.AISLE_LEFT` / `Shots.AISLE_RIGHT` (the two aisles cut through the stalls — the house has none on its centre line, so shot 9 tracks up the house-left one), `Shots.PERFORMER` (where shots 5, 6 and 7 compose on him: he comes on from `entryX`, arrives at `centreX`, stands at `standZ`, and his head is at `headY`), and `Shots.ROW_G_SUBJECT` (the one shot 10 watches).

# ovation.film The shared spine of **Standing Ovation** — a 90-second cinematic demo set in a rotting 1,412-seat theatre. Two things live here and nothing else. ## The constants The Odeon Marisol's geometry (`Film.GEO`, `Film.rakeY`, `Film.stallSeat`, `Film.balconySeat`), its palette (`Film.PALETTE`), its four light sources (`Film.LIGHTS`), its acts (`Film.ACTS`) and its shot list (`Film.SHOTS`). Every slice of the demo reads its colours and dimensions from here rather than restating them, because two slices disagreeing about where row A stands breaks the film in a way no screenshot explains. ## The film clock One deterministic timeline the whole demo runs on. It advances a **fixed 1/24 s per rendered frame** — it reads no wall time and no real frame delta, so the same build produces the same 2,160 frames on any machine, under a recorder or without one. ```lua local Film = require("ovation.film") Film.rewind() -- every reset hook fires, every cue re-arms, t = 0 Film.play() -- the Director advances it from the next rendered frame Film.on("mine", function(t, dt, shot) end) -- called every frame Film.at(47.0, "cue", function() end) -- once, as the clock crosses 47 s Film.reset("mine", function() end) -- back to the t = 0 state ``` `Film.stop()` freezes it with the frame still composed. `Film.seek(t)` lands on a moment for authoring and does not fire the cues in between. `Film.ramp`, `Film.smooth` and `Film.wave` are the shared shaping helpers: this film is made of waves crossing 1,412 identical figures. Only `ovation.director` calls `Film.tick`.