# moments The staged beats of *First Light: The Three Fires*, as cutscene definitions. ```luau local M = require("game.light.moments") cutscene.play(M.opening()) cutscene.play(M.ending("triunity", false)) ``` | Builder | The beat | |---|---| | `M.opening()` | Three shots, 10.2 s: the plateau from beyond the southern rim with the eastern sky over it, a fall to the Eternal Well, and a settle into the framing the game is played in. | | `M.ending("triunity", cardIsUp)` | 7.4 s: lift off the keeper, then level out facing the sunrise with the three fires standing between the camera and the light. | | `M.ending("grey", cardIsUp)` | 7.0 s: drift low toward Adur Farnbag, then back away under a sky that never quite caught. | | `M.ending("lost", cardIsUp)` | 6.4 s: hold on the dark keeper, then rise off the plateau — three cold altars, the stars still out. | `cardIsUp` says the end card is already on screen, and drops the beat's letterbox so it does not cut the card in half. The loop declares a total loss the moment the third fire dies rather than waiting for dawn, so the lost beat usually plays under its card. ## Why they are built and not written down Each builder runs at the moment it is played, because the lens every shot uses is derived from the LIVE screen shape — the same beat has to read on a phone held upright and on a television, and one fixed field of view cannot do both. The rule is the one `TempleCam` frames the game with: keep the authored angle where the screen is wide enough, open up where it is not, and never past 72°, where the frame starts to read barrelled. A shot that wants more than that is asking a 3:4 frame to hold more ground than it can — shrink its `span` instead of raising the ceiling. Every anchor is a world position taken from `FL`. No shot names an entity, so a beat still plays while another slice is rebuilding the thing it looks at — a shot whose anchor names a missing entity is refused outright. ## Nothing here speaks The Old Keeper's lines are the loop slice's, said through `FL.say` and captioned by the screens slice. A cutscene carrying its own subtitles would print every line twice.

# firstlight The hour between deep night and first light on the Parthian ridge, written as a ramp. ```luau local Ramp = require("game.light.firstlight") local look = Ramp.at(0.42) -- 0 = deep night, 1 = the sun clear of the ridge ``` `M.at(light)` reads the whole environment off ONE axis and hands back a `Look`: | Field | What it carries | |---|---| | `sun` | the directional light's travel `dir`, its `color` and `intensity` | | `ambient` | the ambient light's `color` and `intensity` | | `sky` | `timeOfDay`, `stars`, `exposure`, `turbidity`, `sunSize`, `sunIntensity` and the `zenith` / `horizon` / `ground` colours | | `fog` | the depth fog's `density` and `color` | | `grade` | what the post-process chain runs: `exposure`, `contrast`, `saturation`, `brightness`, `tint`, `vignette`, `vignetteRadius`, `bloomThreshold`, `bloomIntensity`, `bloomRadius` | | `sunAltitude` | degrees the sun stands over the ridge; negative is still under it | Four keys carry the ramp, and `M.keys()` hands them back for anything that wants to draw it rather than fly through it: | `light` | The key | |---|---| | `0.00` | deep night — indigo, stars out, ember the only warm light | | `0.55` | the greying — the rim separates from the sky, the stars thin | | `0.80` | first blush — rose along +Z, the sun still under the ridge | | `1.00` | first light — the disc clears the ridge and the plateau goes gold | `Stage.component` owns the axis and pushes what this returns at the scene every frame. Nothing else writes the sky, the sun, the ambient or the grade. ## Two numbers here are measured, not chosen **The sun's heading.** `ProceduralSky` places its own disc from `timeOfDay`, and the scene keeps `syncSunToLight = false` so this ramp owns the directional light — so the disc and the light agree only where the heading is aimed at the disc the sky actually draws. It was read off a capture looking up the arena at the first-light key: 17 degrees right of +Z, 9 degrees over the ridge. Change `timeOfDay` on the top keys and the heading has to be re-measured. **`grade.contrast` is near zero all night on purpose.** The colour-correction pass pivots contrast at mid-grey, and the night frame sits about two per cent off black — so a contrast of 0.05 takes the whole plateau under zero and the frame comes back solid black, with no error anywhere and every value reading back exactly as it was set. The night is shaped with the tonemap's exposure and the vignette instead. There is room for contrast only once the sky has enough light in it to take it.

# FL <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.