summaryrefslogtreecommitdiff
path: root/examples/micscope/README.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-17 00:19:38 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitc37f1b3b1374df2a2a434d16cd772a4bb00c567e (patch)
tree4feccf16cf1f6808bae6ba26602705d557ab2fb7 /examples/micscope/README.md
parent9bd77e54943d954291b5faef287ccca5dcebd7a4 (diff)
downloadsketchbook-c37f1b3b1374df2a2a434d16cd772a4bb00c567e.tar.gz
sketchbook-c37f1b3b1374df2a2a434d16cd772a4bb00c567e.zip
micscope: on the scope module, its copy of the scope code gone
micscope carried the code the scope module was lifted from: seven shaders byte for byte, its layouts but for a comment, and a private live view (Live, analyseLive, drawLive) that was Scope.push, scroll and spectrum. Now the live view is ss.live, a scope.Scope, pushed the microphone and drawn with the panel's world rects and the camera (Views.camera), every frame, clipped away while a recording stands in for it so its columns keep up as before; the tuner reads its history from ss.live.gpu.tape. The take panels run scope.kernels and scope.pipelines over the tape with scope.layouts' blocks, wavePass and spectrogramPass inlined at their one use; maxFreq, min_freq and floor_db are the scope's. src/layouts.zig keeps only the tuner's blocks, the build compiles only the tuner's two shaders, and the tuner names notes with scope.midi, scope.hz and scope.note_names. Takes, transport and tuner are as they were. 1003 lines out, 91 in. Tests: zig build test, 67/67 steps, 10/10 tests (the live history's own test went with it; the scope module tests the same). Pictures: the four scripts' 18 screenshots, captured before and after with the same scripts and compared pixel by pixel (two runs before differ by themselves wherever wall-clock playback or microphone timing shows: the playheads, how far the live view has filled). The one difference not of that kind is the live spectrum: micscope made every image at most 132 rows, so its 184-row spectrum was stretched from 132; the scope makes it at its size, so the live spectrum's lines come out crisp (at most 86 in a channel, inside its rect). The take spectra keep micscope's 132. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'examples/micscope/README.md')
-rw-r--r--examples/micscope/README.md7
1 files changed, 6 insertions, 1 deletions
diff --git a/examples/micscope/README.md b/examples/micscope/README.md
index 759c27c..bd55ee0 100644
--- a/examples/micscope/README.md
+++ b/examples/micscope/README.md
@@ -26,6 +26,11 @@ piccolo's top, against any A4 (`[` and `]`, 440 Hz by default).
Panels are rendered at world resolution and the camera only scales them,
so moving or zooming it recomputes nothing.
+The waveform, spectrogram and spectrum shaders are sketchbook's `scope`
+module's (`src/scope/shaders/`): the live view is a `scope.Scope`, and the
+take panels run `scope.kernels` and `scope.pipelines` over the tape. The
+tuner's are micscope's own.
+
| Shader | Does |
| --- | --- |
| `spectrum.comp` | Blackman-Harris window around the playhead, zero-padded 2×, radix-2 Stockham FFT (8192 points, one workgroup), dBFS per bin, then one value per log-spaced pixel column: a Catmull-Rom spline through the bins where columns are narrower than a bin, the loudest bin where they span several. Smoothed in time (fast attack, slow release) with falling peaks. |
@@ -39,7 +44,7 @@ offset), uploaded once. A take's waveform and spectrogram are recomputed
only when its view changes, and its panel redrawn only when something on
it moved; only the selected take's spectrum runs every frame.
-The live view uploads the microphone's last 1.4 s each frame and analyses
+The live view (the scope module's) uploads the microphone's last 1.4 s each frame and analyses
only the columns that became complete, into ring buffers the fragment
shaders read from the oldest column. A column waits until everything its
spectrogram windows reach has been heard (6160 samples past its centre),