diff options
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 (░▒▓ ▀▄▌▐ ▖▗▘▝); |
