diff options
| author | Manuel Stoeckl <code@mstoeckl.com> | 2025-04-17 18:30:11 -0400 |
|---|---|---|
| committer | Manuel Stoeckl <code@mstoeckl.com> | 2026-02-28 20:17:00 -0500 |
| commit | 290ce2a9c13019b1ee2841b0e1881da4e407e9fb (patch) | |
| tree | 38d088964e7a5bbf3ae8fbd48944b899e4a777f0 /protocol | |
| parent | tests: Add test for using a proxy with a destroyed queue as a factory (diff) | |
| download | wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar.gz wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar.bz2 wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar.lz wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar.xz wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.tar.zst wayland-290ce2a9c13019b1ee2841b0e1881da4e407e9fb.zip | |
protocol: elaborate on drm_fourcc.h and wl_shm.format codes
Wayland clients should not assume the format list will not grow, or
assume the format descriptions in the Wayland protocol are complete.
(The latter fact is clear for descriptionless enum entries like
XRGB8888_A8; but, for example, the full XRGB16161616F format
description explicitly requires IEEE 754 binary16 floats instead
of bfloat16 or ARM's alternative half precision variant.)
Signed-off-by: Manuel Stoeckl <code@mstoeckl.com>
Diffstat (limited to 'protocol')
| -rw-r--r-- | protocol/wayland.xml | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/protocol/wayland.xml b/protocol/wayland.xml index 6d3a056f..19f18479 100644 --- a/protocol/wayland.xml +++ b/protocol/wayland.xml @@ -312,7 +312,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. @@ -482,6 +483,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> |