# Design This file fixes the timeline, the camera and the frame counts. The renderer can vary, as long as the numbers here hold. ## Camera A turntable about the vertical axis, radius and height in `fixtures/crystal-camera.json`. Frame i is angle `360 * i / frames` degrees. ## Tolerance CPU reference: 4 levels, 99% of pixels, or an exact hash if the file says so. Shader versus CPU: 12 levels, 96% of pixels, optional in CI. ## SDF An original crystal (a combination of a polyhedron and a few cuts), in `fixtures/crystal-sdf.txt` or in code with a comment that points at the file. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `frames` | Turntable frames | 36 | From 12 to 72, a full turn. | | `width` | Frame width | 960 | 640, 960 or 1280. | | `height` | Frame height | 540 | 360, 540 or 720, or equal to width for a square. | | `iridescence` | Iridescence | on | A documented wavelength-dependent term. If off, a still dielectric is used. | | `environment` | A simple environment | on | A shipped lighting environment, not a live probe. | | `renderer` | Renderer | shader | shader is a GPU or WebGL marcher. cpu is a software marcher used as the CI reference. | ## Acceptance at the defaults A turntable of an original SDF crystal. Default 36 frames, 960 × 540, iridescence and a simple environment on. | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Frame count | 36 | 0 | A full turn, frame i at 360 * i / 36 degrees | | Frame size | 960 × 540 | exact | `width` × `height` | | Camera radius, height | 3.00, 0.80 | 0.01 | Scene units, in the camera file | | Look-at | (0, 0, 0) | exact | The crystal's origin | | Iridescence | a thin-film term, 0.4 µm | — | When `iridescence` is on | A CPU marcher is the CI reference. Frames 0, 9, 18 and 27 are goldens (4 levels, 99% of pixels against the CPU). A shader path, when chosen, may be looser (12 levels, 96%) and is optional in CI. The SDF is original. ## Screenshots These pictures are frames from the reference renderer in `reference/preview.py`, at the default inputs. They are not drawings of a product that has not been built or simulated. The first picture is the one Spekkr shows on the spec's card. A build may ship its own goldens; those goldens are of that build and do not have to match these frames pixel-for-pixel. | File | What it shows | | --- | --- | | `shots/pose-0.png` | Crystal frame 0 of 36, 960 × 540, iridescence on | | `shots/pose-9.png` | Crystal frame 9 of 36 (90°), 960 × 540 | ## How to verify 1. Render the documented frames at the default `fps`, size and hold or frame count. 2. Compare each named golden to the timeline or camera file in this document, within the stated tolerance. 3. Confirm the total frame count matches the table. 4. 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.