# Design This file fixes the parts that are easy to get wrong. The language and tools are up to you, as long as the numbers here hold. ## Stops (`life`) The exact table is `fixtures/scale-stops.json`. It includes, in metres: bacterium 2e-6, cell 3e-5, grain 1e-3, finger 7e-2, hand 1.8e-1, person 1.7, room 5, tree 20, hill 200, city 2e4, country 1e6, planet 1.274e7. Camera height is `length * 3.2` world units, with a world unit of 1 metre at the `person` stop. Tests compare height to 0.5%. `short` is stops bacterium, hand, person, tree, planet. ## Screenshot tolerance 8 levels, 98% of pixels, 1600 by 1000, settled, no crossfade in motion. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | From a cell to a world | Shown at the first stop. | | `units` | Unit system | metric | Labels only. The math in design.md is in metres and always holds. | | `labels` | Show size labels | on | Each stop names the object and its length. | | `crossfade` | Crossfade stops | on | A short dissolve between two stops. Tests may take the settled frame. | | `path` | Zoom path | life | life is the full twelve-stop path. short is five stops, for quicker checks. | ## Acceptance at the defaults The numbers, names and fixture paths already in this file are the authority. Where a later table or a shipped fixture file disagrees with prose, the table or the fixture wins. | Fixture | Role | | --- | --- | | `design.md` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/scale-stops.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `spekkr.inputs.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | Golden frames are compared at 1400 by 1000 CSS pixels unless a requirement names another size. Tolerance, unless a tighter figure is given above: 8 levels, 98% of pixels, with motion, cursors and clocks frozen as this file says. A build's goldens are of that build; they do not have to match a shipped reference preview pixel-for-pixel if the tool or the type is different, but they do have to match this file's layout, counts and copy. ## Screenshots These pictures are headless-Chrome captures of the working reference in `reference/preview.html`, at the default inputs. They are not drawings of a product that has not been built. 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/leaf.png` | The zoom parked on a leaf, 5 cm, mid-way from a cell to a planet. | ## How to verify 1. Run the checks at the default inputs, without a network. 2. Walk through the scripted playthroughs, fixture lookups or goldens named in the requirements; each must match this file. 3. Repeat once at the person's inputs when they differ from the defaults. 4. Scale math tests place each stated object at a documented zoom and camera height. A mid-point between two stops is the geometric mean of their lengths. Golden frames are taken at four stops. No live dataset and no network.