summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAge
* text: sk.text.places, every byte's place in one layoutGabriel Schneider4 days
| | | | | | | | | | | | | | | | | | | | | | | An editor draws a range under its bytes, a caret on its glyph, a mark under a byte, and finds the byte under the pointer; with mixed sizes on a line a column is no longer a measure. `layout`'s `caret` gives one byte's place a layout, so a range, a caret and a hit test were a layout a byte. `sk.text.places(bytes, paragraph, out)` is the same layout with every byte's place in `out` (where a caret before that byte sits, a `Caret`: x, the line's top and height; a `\n` and the spaces a line wraps at are at its end, and one more for the end of the text). The byte at a point is then a loop over places: the last whose line holds its y and whose x is at or left of it. `lay` takes the slice to fill (empty: none), so `layout`, `places` and `f.paragraph` stay one function. Pure, as `layout`: in `update` too. The README's editor recipe and docs/text.md say so. Test: a paragraph's places are where its caret sits, byte by byte (wrapped at a space, a `\n`, a span twice the size, a two-byte codepoint, a last empty line). zig build test-text: 52 of 52 steps. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
* docs/text.md: sketchbook's text on pardes's rasterizer, the designGabriel Schneider4 days
| | | | | | | | | | | | | The calls a sketch has after the move to FreeType and HarfBuzz, what each existing call becomes, where shaping and metrics run (one host entry, textRun, served as data and reached from update through the glue; a sketch's tests link the same static library), sizes under textScaled, the faces and their one fallback, the renderer's atlas and batching, and what the web does (canvas measureText). Recorded for review before the code. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
* gpu: add a post-process pass with optional depth sampling, and describe the ↵Gabriel Schneider4 days
| | | | | | | | | | executor pardes shares `f.postProcess(source, target, .{...})` records a fullscreen pass that samples a completed render into a distinct target image: colour at fragment binding 0 and, with `sample_depth`, depth at 1, which needs the source's latest pass to have depth and one sample (missing depth, multisampled depth and feedback loops are rejected). The scene format's version 4 carries it, the executor records it on the caller's command buffer and owns the sampler, the web host does the same with its texture and sampler pairs, and native profiling reports the work as `postprocess`. The README says how to use it. docs/pardes-rendering.md describes the executor as pardes uses it for addon scenes: a borrowed SDL GPU device, `record` into the caller's command buffer, `run`, `output` and `postProcess`. The working copy as it stood on 2026-11-16; message written by Claude from the diff, at the author's request.
* sketchbook: design for editing regions in sourceGabriel Schneider2026-09-25
docs/regions-in-source.md: named regions that remember where they were written (@src), an overlay to see and drag them, and a host-side patcher that rewrites the literals with std.zig.Ast, so hot reload shows the edit. Also scripts clicking regions by name. Not implemented yet.