docs/deccara.rst
There already exists an escape code to set some text attributes in arbitrary
regions of the screen, DECCARA <https://vt100.net/docs/vt510-rm/DECCARA.html>__. 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 :iss:this discussion <160#issuecomment-346470545>
and this FAQ <https://invisible-island.net/ncurses/ncurses.faq.html#bce_mismatches>__
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