# 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. ## Stroke tape Coordinates are in [0, 1] of the field. The file is the authority. Dye checksums (a 64-bit hash of the 256-grid dye, quantised to 8 bits) are `fixtures/fluid-checksums.json`. ## Screenshot tolerance 12 levels, 96% of pixels (fluids smear). The checksum is exact on a CPU reference; a GPU run may use the looser image tolerance only, if a flag says so, but CI should run the CPU reference. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Smear the ink | Shown faintly in a corner. | | `viscosity` | Viscosity | 0.8 | From 0.1 to 2.0, the solver's diffusion amount. | | `dye` | Leave dye | on | A colour field is advected with the velocity. If off, only the velocity is drawn as lines. | | `bounds` | Closed bounds | on | No-slip walls. If off, the field wraps. | | `resolution` | Field resolution | 256 | The velocity grid. Tests run 128 and 256. | ## 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 | | --- | --- | | `fixtures/fluid-checksums.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/fluid-stroke.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/smear.png` | A scripted ink smear on the deterministic solver, viscosity 0.8. | ## 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. A scripted stroke on a deterministic solver produces a golden frame and a dye checksum. Rest-state residual, closed bounds, dye range, and a no-NaN check are tested. A CPU reference is preferred in CI. No network.