From ce059cffdb0cbf80b06da2553be2d2f5e4fec085 Mon Sep 17 00:00:00 2001 From: Pekka Paalanen Date: Fri, 11 Mar 2022 11:40:44 +0200 Subject: [PATCH] man: expand on gbm-format Since 62a9436417eb4e1ba53f5c54ef9a0e8b5a4eb53f 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 --- man/weston-drm.man | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/man/weston-drm.man b/man/weston-drm.man index 1adada57..017124aa 100644 --- a/man/weston-drm.man +++ b/man/weston-drm.man @@ -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