Merge branch 'doc-format' into 'main'

protocol: elaborate on drm_fourcc.h and wl_shm.format codes

See merge request wayland/wayland!468
This commit is contained in:
M. Stoeckl 2025-09-20 16:01:57 +00:00
commit d61c13f947

View file

@ -304,7 +304,8 @@
The drm format codes match the macros defined in drm_fourcc.h, except
argb8888 and xrgb8888. The formats actually supported by the compositor
will be reported by the format event.
will be reported by the format event. See drm_fourcc.h for more detailed
format descriptions.
For all wl_shm formats and unless specified in another protocol
extension, pre-multiplied alpha is used for pixel values.
@ -454,6 +455,10 @@
Informs the client about a valid pixel format that
can be used for buffers. Known formats include
argb8888 and xrgb8888.
Extensions to drm_fourcc.h (or the format enum) do not require
increasing the wl_shm version; as a result, clients may receive format
codes which were not in the list at the time the client was made.
</description>
<arg name="format" type="uint" enum="format" summary="buffer pixel format"/>
</event>