man: expand on gbm-format

Since 62a9436417 the gbm-format option has
recognized all pixel formats listed in libweston/pixel-formats.c.

Clarify what pixel formats can be used.

Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
This commit is contained in:
Pekka Paalanen 2022-03-11 11:40:44 +02:00 committed by Marius Vlad
parent 1f5e19fab3
commit ce059cffdb

View File

@ -46,11 +46,20 @@ The DRM backend uses the following entries from
.SS Section core
.TP
\fBgbm-format\fR=\fIformat\fR
sets the GBM format used for the framebuffer for the GBM backend. Can be
.B xrgb8888,
.B xrgb2101010,
.B rgb565.
By default, xrgb8888 is used.
Sets the default pixel format for DRM KMS framebuffers.
.IR Format " can be"
.BR xrgb8888 ", " xrgb2101010 ", " rgb565
or others. Weston recognizes the names of most pixel formats defined by
the kernel DRM subsystem in
.B drm_fourcc.h
header without the DRM_FORMAT_ prefix.
The actually supported pixel formats depend on the DRM driver and hardware,
and the renderer used. Using Pixman-renderer, DRM-backend supports only
.BR xrgb8888 " and " rgb565 .
The formats supported with GL-renderer depend on the EGL and OpenGL ES 2 or 3
implementations. The names are case-insensitive.
.RB "If not specified, " xrgb8888 " is used."
.TP
\fBpageflip-timeout\fR=\fImilliseconds\fR
sets Weston's pageflip timeout in milliseconds. This sets a timer to exit