# Design This file fixes the timeline, the camera and the frame counts. The renderer can vary, as long as the numbers here hold. ## Fixture scene A short scene: a title, an equation that rearranges, an optional small plot. Duration and the key times are `fixtures/math-scene.json`. At 30 fps and hold 1.0, the expected count is in that file. ## Positions Coordinates are in frame pixels, origin top-left, or in a documented scene space. The key file is the authority. ## Tolerance Same renderer: exact or 2 levels. Across browser and python: 8 levels, 98% of pixels, plus the position bound still holds. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | A small proof, moving | Shown in the opening card, or as the first equation's label. | | `fps` | Frames a second | 30 | 24 or 30. | | `hold` | Hold, seconds | 1.0 | How long a settled equation stays, from 0.4 to 2. | | `labels` | Axis labels | on | On scenes that have a plot. | | `subtitle` | A subtitle | on | A short line under the title card. | | `renderer` | Renderer | browser | browser is a Web or canvas renderer. python is a Manim-like or a small shipped renderer. Both must match the same frame count and positions. | ## Acceptance at the defaults A short, deterministic motion piece. Default 30 fps, 1.0 s hold, title 'A small proof, moving', labels and subtitle on. The timeline is the authority. | Quantity | Value | Tolerance | Source | | --- | --- | --- | --- | | Frame rate | 30 fps | exact | `fps` | | Hold of a settled card | 1.0 s | 0.05 s | `hold` | | Opening title duration | 1.2 s | 0.05 s | Ease in, hold, ease out as in the key file | | Total frames at defaults | 240 | 0 | Eight seconds including holds | | Title text | A small proof, moving | exact | `title` | A key file lists, for each named mark, its x, y (and optional opacity, scale) at each key time. In-between frames are linear or a documented ease. Goldens: the title card, a mid-transform, a settled equation, and the last frame. No physical camera is required. ## 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/title-card.png` | Title card “A small proof, moving”, 30 fps | | `shots/settled.png` | Settled equation after the documented hold | ## 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. Fixture scenes render to a documented frame count. Golden frames are taken at stated times, and text or shape positions at a couple of keyframes are asserted. Two runs of the same renderer agree. No network is required. The product does not use a famous channel's name.