Graphics protocol: Make it explicit what is supposed to happen when two images with the same z-index overlap

Fixes #5187
This commit is contained in:
Kovid Goyal 2022-06-10 22:10:11 +05:30
parent 646bdbd002
commit e1ad75e932
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C

View File

@ -417,7 +417,9 @@ they are semi-transparent. You can specify z-index values using the ``z`` key.
Negative z-index values mean that the images will be drawn under the text. This Negative z-index values mean that the images will be drawn under the text. This
allows rendering of text on top of images. Negative z-index values below allows rendering of text on top of images. Negative z-index values below
INT32_MIN/2 (-1,073,741,824) will be drawn under cells with non-default background INT32_MIN/2 (-1,073,741,824) will be drawn under cells with non-default background
colors. colors. If two images with the same z-index overlap then the image with the
lower id is considered to have the lower z-index. If the images have the same
z-index and the same id, then the behavior is undefined.
.. note:: After placing an image on the screen the cursor must be moved to the .. note:: After placing an image on the screen the cursor must be moved to the
right by the number of cols in the image placement rectangle and down by the right by the number of cols in the image placement rectangle and down by the