diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-04 20:54:21 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-04 21:12:33 -0300 |
| commit | 0ff1fc99eb870f8a1e714a71c1a853066737c822 (patch) | |
| tree | 2c8b4720e2ed190e6f9062cfe8586c3da22aeb42 /docs/render-pipeline.md | |
| parent | 3b082687c7da1c5d8cc52c71fdf4ddd38d860cd8 (diff) | |
| download | pardes-0ff1fc99eb870f8a1e714a71c1a853066737c822.tar.gz pardes-0ff1fc99eb870f8a1e714a71c1a853066737c822.zip | |
rename: the terminal frontend is the tui (-Dplatform=tui, src/tui/tui.zig, --tui with --tty kept as its old spelling, the process tests' backend .tui and --backend=tui, docs/typ/builtins-tui.json, the Settings report's platform), and the builtin Tty is Term (its registry entry, SPC n t, every default tag, the docs, tests and snap scripts), Tty still run as Term through exec.acme_words, Tty+fish too on a tag and a ctl; tty as a pane's raw mode and as the OS's terminal unchanged
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'docs/render-pipeline.md')
| -rw-r--r-- | docs/render-pipeline.md | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/render-pipeline.md b/docs/render-pipeline.md index 9d41f7fa..ba5d131e 100644 --- a/docs/render-pipeline.md +++ b/docs/render-pipeline.md @@ -27,7 +27,7 @@ Ticks (`Event.tick`) are produced by six different clocks: | shell | who ticks | cadence | |---|---|---| -| tty | `tickWatch` thread: nanosleep 16 ms **after** the wait asked, then `postEvent(.tick)` (tty.zig:1513) | 16 ms + frame time: drifts slow, worse over ssh | +| tty | `tickWatch` thread: nanosleep 16 ms **after** the wait asked, then `postEvent(.tick)` (tui.zig:1513) | 16 ms + frame time: drifts slow, worse over ssh | | gui | `AnimationClock.due` in `postPresent` re-arms `now+16ms` (gui.zig:203, 221, 4095) | a tick only once ≥16 ms have passed since the re-arm: at 144 Hz every 3rd frame (20.8 ms) → animations ~25% slow; at 120 Hz every 2nd; a slow frame slows them further | | gui grid mode | every `poll_frame` while active (gui.zig ~4114) | as fast as the loop | | web | JS rAF fixed-step bank, capped (app.mjs:566) | correct average rate, always ticking | @@ -38,7 +38,7 @@ So the same animation runs at different speeds per shell. Everything counts 16 ms frames (`layout.Animation.frame_ms`, layout.zig:2041). Acknowledgement is also per shell: tty `postPresent` acks the tracks it drew -(tty.zig:1187), GUI acks then ticks (`finishPresentedAnimationFrame`), grid mode +(tui.zig:1187), GUI acks then ticks (`finishPresentedAnimationFrame`), grid mode acks `&.{}`, macOS acks via `pardes_frame_presented`, **web never acks**. ### 1.2 Core render (`Pardes.render`, pardes.zig:5950), in code order @@ -83,7 +83,7 @@ set `cell.hover`, 378-385 — a side channel for macOS glass). ### 1.4 Shells -- **tty** (tty.zig:1100): `panel_compositor.compose` rewrites cells for +- **tty** (tui.zig:1100): `panel_compositor.compose` rewrites cells for slide/zoom/dissolve/vertical → `paintCells` (win.clear + every cell) → kitty images (hidden while geometry moves) → cursor → `vx.render` (vaxis diffs against its last screen, wraps in sync 2026). Layers are ignored. @@ -698,8 +698,8 @@ character effects (ascii…typewriter) → not a GUI effect (terminal track). ### 9.2 Terminal track (tty, cell-native; separate, smaller) -Where: presentation-only cell rewrites in the tty shell after the canonical -grid (`tty/panel_compositor.zig` grows into the tty compositor), never in the +Where: presentation-only cell rewrites in the tui shell after the canonical +grid (`tui/panel_compositor.zig` grows into the tty compositor), never in the canonical grid, so 9P/goldens stay clean with effects off. Gated on truecolor (vaxis caps / COLORTERM) — static effects may quantise to 256, animated ones turn off below truecolor. Safe glyph set by default (░▒▓ ▀▄▌▐ ▖▗▘▝); |
