aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorTim Culverhouse <tim@timculverhouse.com>2026-07-28 19:16:05 +0000
committerDaniel Eklöf <daniel@ekloef.se>2026-07-30 12:18:58 +0000
commit8db88cceb758b5be23e7db1fe74a48102ab07dc0 (patch)
tree2741b009de1520e2203d4b6695073422c77df738 /doc
parentchangelog: add missing bug reference (diff)
terminal: add visibility reports
Applications cannot infer whether their terminal view is observable from keyboard focus alone, so they may continue expensive rendering while the surface is hidden. Implement private mode 2033 and the one-shot visibility query. Report Wayland xdg_toplevel suspension as not visible and otherwise remain conservative by treating the terminal as potentially visible. Amp-Thread-ID: https://ampcode.com/threads/T-019fb2b7-f245-7124-a69a-1484812532bb Co-authored-by: Amp <amp@ampcode.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/foot-ctlseqs.7.scd12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/foot-ctlseqs.7.scd b/doc/foot-ctlseqs.7.scd
index 40906ebf..192628cd 100644
--- a/doc/foot-ctlseqs.7.scd
+++ b/doc/foot-ctlseqs.7.scd
@@ -340,6 +340,12 @@ that corresponds to one of the following modes:
| 2031
: contour
: Request color theme updates
+| 2033
+: rockorager
+: Request terminal visibility reports. Enabling this mode immediately reports
+ the current visibility as *CSI ? 999 ; 1|2 n*, where *1* means potentially
+ visible and *2* means not visible. Further reports are sent whenever the
+ visibility changes.
| 2048
: TODO
: In-band window resize notifications
@@ -667,6 +673,12 @@ manipulation sequences. The generic format is:
997 ; 1|2 n*, where *1* means dark and *2* light. By convention, the
primary theme in foot is considered dark, and the alternative theme
light.
+| \\E[ ? 998 n
+: Query terminal visibility
+: rockorager
+: The current terminal visibility is reported as *CSI ? 999 ; 1|2 n*, where
+ *1* means potentially visible and *2* means not visible. This does not enable
+ private mode 2033.
# OSC