# Iridescent crystal ## What this builds A short, lush loop: a crystal, defined as an SDF, turns on a turntable, with an optional iridescent shading. The look is original. A deterministic turntable of N frames is compared to goldens with a stated tolerance. Optional stills at documented camera poses are included. The CPU renderer is the CI reference; a shader may be compared with a looser tolerance. No film set and no capture stage are required. Read `spekkr.inputs.json` first. `frames` is a full turn. `width` and `height` size the picture. `iridescence` and `environment` change the shade. `renderer` is the engine. Tests pin a seed if noise is used; the default has no noise, or a seeded one. ## Out of scope - A live environment probe, a film set, or a photogrammetry capture. - A copyrighted gem photograph as the product. - A network render farm in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. The turntable - A full turn of `frames` frames, camera as in `design.md`, is deterministic: two CPU runs hash the same frames, or match within 1 level if a documented float slack exists. - Frame 0, a quarter turn, and a half turn match goldens within the tolerance in the file (tighter on the CPU reference). - If `iridescence` is off, a still dielectric term is used, and a fourth golden or a documented skip applies. Accept when: the two CPU runs agree, and the three (or four) goldens match within tolerance. ### R2. Poses, files - Optional stills at the camera poses in `fixtures/crystal-poses.json` (for example a close-up) match goldens. - One command renders the turntable and the stills, compares, and writes the four named shots. No network. CI uses the CPU reference. - A seed, if any, is pinned. A hook fails if a live HDRI host is contacted. Accept when: the command passes, the hook stays quiet, and a deliberately wrong SDF (a sphere) fails the crystal goldens. ### R3. Inputs - Inputs are read from `spekkr.inputs.json`. `fps`, `hold` or `frames` and the frame size stay inside the ranges in `design.md`. - A value outside a range is refused before a render. Accept when: an illegal input is refused by name, and the default timeline has the frame count in `design.md`. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification A deterministic turntable of N frames matches toleranced goldens on a CPU reference. Optional stills at documented camera poses are checked. Iridescence is a documented shader term, not a lab measurement. No film set, no capture stage, and no network are required. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to render the loop, how the CPU reference is run, and how tolerances are listed.