# 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. ## Samples Cursors in a 1600 by 1000 page: the file lists (x, y), the chosen image id, and the expected landing error in pixels. Tests compare ids exactly and error to 0.5 px. ## Placement The image is translated so its pointer coordinate maps to the cursor, then cropped to the page. No scale, no rotate, in this version. ## Screenshot tolerance 8 levels, 98% of pixels. The landing error is a geometric check, not an image hash. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Someone is pointing at it | Shown in a quiet corner. | | `tolerance` | Pointer tolerance, px | 24 | How close the drawn pointer must land to the cursor, from 8 to 48. | | `crosshair` | Show a crosshair | off | A faint mark at the cursor, useful in tests. | | `credits` | Show a credit | on | A caption under the figure from the fixture's credit field. | | `set` | Image set | studio | A shipped set of original drawings, each with a pointer coordinate. | ## 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/pointer-samples.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/hero.png` | An original drawing of a figure pointing at the cursor, 11 px off. | ## 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 fixture image set is used, never a live camera or a scraped gallery. For sampled cursor positions, the chosen figure's pointer lands within a documented pixel tolerance, and the chosen id matches a file. Credits and licences are shipped. No network.