diff options
| author | sl0p <sl0p@sl0p.foo> | 2026-08-14 01:01:04 +0200 |
|---|---|---|
| committer | sl0p <sl0p@sl0p.foo> | 2026-08-14 01:01:04 +0200 |
| commit | b6c175e58ee21e2532d2826411a5351d9a676c09 (patch) | |
| tree | 08562ab30350e6353d8f78eb19132d4e8e8a2b09 /docs/scripting.md | |
| parent | sl0ptty: the split guide arms on dwell, not on contact (diff) | |
| download | slosh-b6c175e58ee21e2532d2826411a5351d9a676c09.tar.gz slosh-b6c175e58ee21e2532d2826411a5351d9a676c09.tar.xz slosh-b6c175e58ee21e2532d2826411a5351d9a676c09.zip | |
sl0ptty: kitty graphics passthrough
A program in a pane transmits an image and it appears. libghostty-vt parses
the protocol and tracks images and placements; what a multiplexer has to add
is re-emitting them to the client, which is exactly what tmux and zellij do
not do — and the reason tools fall back to sixel under them.
Per frame: walk the visible tab's panes, transmit each image once (a=t),
place every visible placement (a=p,C=1) after the cell diff so a repainted
cell cannot land on top of one, and delete placements that vanished. Image ids
are remapped into a high range, so two panes both using image 7 stay two
images and neither collides with what the client's terminal already had. A
reattaching client is told everything again, because it has seen nothing.
The cropping rule is the part worth remembering: a placement is N pixels drawn
across M cells, so the placement itself tells you the pixels per cell — the
client's font metrics never come into it. Clipping at a pane edge, or at the
top of the viewport when a tall image is partly scrolled off, moves the source
rectangle; asking for fewer columns or rows alone scales the image into them
instead of cropping it. The first version did exactly that, and dropped
partially-visible placements entirely rather than cropping them.
Tests cover the multiplexer-specific case first: two panes, both using image
id 7, must get different client ids. Then placement position in screen cells,
following the layout, cropping at edges and when taller than the pane, nothing
from collapsed panes, and removal when a pane closes or the image scrolls
away. A live check confirms the wire: transmitted once, re-placed per frame,
not re-transmitted.
416 checks green (389 headless + 27 live).
Diffstat (limited to 'docs/scripting.md')
0 files changed, 0 insertions, 0 deletions
