diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-17 01:32:18 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | 62ab82af9da007a8ff04677943809cf541b1e420 (patch) | |
| tree | 9e0da7051fcf606860ada1d2202f14a768d21182 /examples | |
| parent | 8bf10e316178755b8710e27c807dbf9b6a1d37a8 (diff) | |
| download | sketchbook-62ab82af9da007a8ff04677943809cf541b1e420.tar.gz sketchbook-62ab82af9da007a8ff04677943809cf541b1e420.zip | |
README: one thing a sketch keeps, in one file; what a crash loses; the cap
The manual described a mapped state file, a sessions database beside
it, a probe, private files for scripted runs and exits that compact
past 64 MiB. Now, in The host: "The save" replaces "State file" (one
thing, State, in one file, `<name>.xitdb`; the present restored and
replayed at start; keyframes as pages and what they cost, measured;
layout migration as before; an old `<name>.state` imported once and
left as it was); "Where files go" lists `<name>.xitdb` and the files a
sketch appends to, `--state x.state` and `x.xitdb` naming one save;
"Sessions" says every run is one, `record` decides how much history is
kept (a build that does not record keeps the present and the marks,
the last minute of input at most while it runs, none after), a crash
loses under a second and the next run starts from the last committed
frame; a new paragraph, "The cap": 64 MiB, State half, history dropped
oldest first and the file compacted to three quarters (about 170 ms in
Debug), the present, marks and clips never dropped, a new mark refused
with how to make room. The State row and "Data that grows" say 32 MiB;
the appendFile paragraph names `<stem>.<name>` beside the save; scripts
and exports save nothing; the Build API loses `probe`, `addProbe` and
`probe_exe`; Known limits gains the hash pass's cost. layout.zig's note
on what State may hold says where it is saved; micscope's README names
its takes `micscope.take-<id>.f32`.
Tests: zig build test, 168/168 steps.
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'examples')
| -rw-r--r-- | examples/micscope/README.md | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/examples/micscope/README.md b/examples/micscope/README.md index e917bf0..875ebdf 100644 --- a/examples/micscope/README.md +++ b/examples/micscope/README.md @@ -149,7 +149,7 @@ browser has accepted its self-signed certificate (miniserve prints the addresses as QR codes, for phones). Each take is a file of its samples (mono 32-bit floats at the host's -rate), `micscope.state.take-<id>.f32` beside the state (in `.sketchbook/` +rate), `micscope.take-<id>.f32` beside the save (in `.sketchbook/` under `zig build run`), written as it records (`Host.appendFile`). State lists the takes, so they are still there after a restart. A take starts its file empty (`Host.writeFile`). A deleted take's file stays: a seek |
