# Pulsar ridges ## What this builds A stack of ridges, each a spectrum of a short window of sound, drawn as a 3D mesh you can turn. The look sits in a long tradition of pulsar and ridge plots; the product name, the art and the colour are original, and no album art or trademarked title is used. A fixture audio buffer is enough to build a documented mesh. No microphone is required, in the product's default or in the checks. Read `spekkr.inputs.json` first. `title` sits under the mesh. `rows` is how many ridges. `source` is a fixture buffer or a sine. `fill` and `rotate` change the picture. There is no microphone input in this version. ## Out of scope - A microphone, a live radio, or a copyrighted album as a shipped fixture. - A trademarked album title or cover in the UI or the files. - Network or a streaming service. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. The mesh - The fixture buffer `fixtures/pulse.wav` (or the listed tone: 220 Hz, 1 s, 16-bit, 44.1 kHz) is windowed into `rows` frames, each an FFT of 1024 samples with a Hann window. - Each ridge is the magnitude of bins 0–127, scaled as in `design.md`. The mesh vertex at row i, bin k is in `fixtures/ridges-pulse.json` for the fixture at 48 rows, within 1e-3. - There is no MediaStream or getUserMedia call in the code path the checks use. Accept when: the fixture mesh matches the file, the tone mesh has its peak in the documented bin, and a hook fails if a microphone API is used. ### R2. Frames and files - Goldens: a front view, an angled view at 35 degrees, the tone source, and a flat (rows=16, fill off) view, all settled at 0 if rotate is on, except the angled view. - One command runs the mesh tests, the hook, and writes the frames. No network and no microphone. Accept when: the command passes for both sources, and the frames match the goldens. ### R3. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification A fixture audio buffer produces a documented mesh (and a tone produces a peak in a documented bin). A golden render is taken from two cameras. Checks hook microphone APIs so a mic cannot sneak in. No copyrighted album is shipped. No network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to load the fixture, how to run the checks, and why there is no microphone in this version.