summaryrefslogtreecommitdiff
path: root/docs/render-pipeline.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-04 20:54:21 -0300
committerGabriel Schneider <[email protected]>2026-11-04 21:12:33 -0300
commit0ff1fc99eb870f8a1e714a71c1a853066737c822 (patch)
tree2c8b4720e2ed190e6f9062cfe8586c3da22aeb42 /docs/render-pipeline.md
parent3b082687c7da1c5d8cc52c71fdf4ddd38d860cd8 (diff)
downloadpardes-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.md10
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 (░▒▓ ▀▄▌▐ ▖▗▘▝);