kitty/docs
Kovid Goyal 24f7369bb6
Drop Unicode placeholder cell images scrolled off the bottom of the screen
A full screen reverse scroll (ESC M at the top, CSI T) moves every image
ref down a row. scroll_filter_func() only removed refs that left through
the top, so a cell image on the bottom line ended up at row `lines`, off
screen, while its line was discarded. The next forward scroll brought it
back onto the bottom row, where the line has no placeholders.
screen_render_line_graphics() returns early for such lines, so nothing
removed the ref and a slice of the old image was drawn over the new text.
tmux and pagers send ESC M when scrolling down, so this shows up in
practice. Fix it by dropping cell image refs that move below the bottom
margin, the same way the margins scroll path drops refs that leave the
region.

This replaces PR #10623, which was not merged for these reasons:

- It does not find the cause. It removes cell image refs at render time
  for every line without placeholders, so the stale ref still exists and
  is still seen by anything that reads refs before the next render, such
  as graphics query and delete commands and the paused rendering path,
  which returns before the new code.
- It costs time on every frame. Whenever any image is loaded, even with
  no placeholders at all, each clean visible line and each visible
  history line triggers a walk over all images and refs. Before, such
  lines cost nothing. This fix adds one comparison to a loop that only
  runs when the screen scrolls.

Close #10623
2026-10-07 20:19:23 +05:30
..
_static preserve scroll position when opening and closing vdeo popups 2026-08-10 20:41:32 +05:30
_templates
kittens Fix #10603 2026-10-05 04:16:54 +05:30
screenshots
actions.rst
basic.rst Remove shift from next tab shortcut 2026-05-06 13:11:07 +02:00
binary.rst
build.rst Correct the documentation dependency install command 2026-10-06 16:04:16 +05:00
changelog.rst Drop Unicode placeholder cell images scrolled off the bottom of the screen 2026-10-07 20:19:23 +05:30
clipboard.rst clipboard protocol: Specify handling of invalid base64 data 2026-08-25 10:12:25 +05:30
color-stack.rst Color control protocol: Respond to unknown field names safely using base64 encoding 2026-09-01 21:20:04 +05:30
conf.py ... 2026-09-04 06:35:44 +05:30
conf.rst
custom-shaders.rst Particle effects for cursor trail shaders 2026-10-02 10:05:57 +05:30
deccara.rst
desktop-notifications.rst
dnd-protocol.rst Add a note about text/uri-list lifetime 2026-09-02 10:14:32 +05:30
extract-rst-targets.py autoformat 2026-08-05 05:32:56 +05:30
faq.rst Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
file-transfer-protocol.rst
glossary.rst Update changelog 2026-08-18 08:04:48 +05:30
graphics-protocol.rst Graphics protocol: Fix file descriptor leak that can be triggered by malicious clients 2026-09-14 21:03:15 +05:30
index.rst Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
installer.sh Also use diskutil in a couple more scripts 2026-09-24 09:32:05 +05:30
integrations.rst awrit has been abandoned replace with terminal-browser 2026-08-28 21:42:53 +05:30
intro_vid.rst
invocation.rst
keyboard-protocol.rst Add additional implementations of the keyboard protocol 2026-09-14 16:30:58 -05:00
kittens_intro.rst Docs for the dnd kitten 2026-05-06 08:12:00 +05:30
launch.rst Add support for docked windows 2026-10-01 15:45:44 +05:30
layouts.rst Add support for docked windows 2026-10-01 15:45:44 +05:30
Makefile Fix #10577 2026-10-01 17:23:37 +05:30
mapping.rst Use launch in the remote control example 2026-10-06 16:04:16 +05:00
marks.rst
misc-protocol.rst
multiple-cursors-protocol.rst
notifications.py autoformat 2026-08-05 05:32:56 +05:30
open_actions.rst Use binary XDG shared MIME database for mimetype lookups 2026-10-06 08:27:55 +05:30
overview.rst Drag and drop: Fix issues in tab hover switching and insertion 2026-09-26 15:50:52 +05:30
performance.rst Switch to perf for profiling from gperftools 2026-08-16 11:24:41 +05:30
pipe.rst
pointer-shapes.rst
press-mentions.rst
protocol-extensions.rst
quake-screenshots.rst
quickstart.rst
rc_protocol.rst
remote-control.rst
requirements.txt Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
sessions.rst
shell-integration.rst Fix doubled words in docs and a test comment 2026-08-22 23:10:54 +03:00
support.html
support.rst
text-sizing-protocol.rst Cleanup previous PR and make VS15 on explicit width cell behavior consistent with VS16 2026-09-18 22:59:19 +05:30
underlines.rst
unscroll.rst
wide-gamut-colors.rst