KittyPatch/kitty
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Some documentation for the kitty extensions to DECCARA

Browse Source
This commit is contained in:
Kovid Goyal 2017-12-17 18:08:25 +05:30
parent d48b76508b
commit c8d5f232b3
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
protocol-extensions.asciidoc
View File

@ -156,3 +156,26 @@ For example:
This encoding means each key event is represented by 8 or 9 printable ascii This encoding means each key event is represented by 8 or 9 printable ascii
only bytes, for maximum robustness. only bytes, for maximum robustness.
== Setting text styles/colors in arbitrary regions of the screen
There already exists an escape code to set *some* text attributes in arbitrary
regions of the screen,
link:https://vt100.net/docs/vt510-rm/DECCARA.html[DECCARA]. However, it is
limited to only a few attributes. kitty extends this to work with *all* SGR
attributes. So, for example, this can be used to set the background color in
an arbitrary region of the screen.
The motivation for this extension is the various problems with the existing
solution for erasing to background color, namely the *background color erase
(bce)* capability. See
link:https://github.com/kovidgoyal/kitty/issues/160#issuecomment-346470545[this discussion]
for a summary of problems with *bce*.
For example, to set the background color to blue in a
rectangular region of the screen from (3, 4) to (10, 11), you use:
```
<ESC>[2*x<ESC>[4;3;11;10;44$r<ESC>[*x
```