summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorPekka Paalanen <pekka.paalanen@collabora.com>2022-03-04 17:08:52 +0200
committerPekka Paalanen <pq@iki.fi>2022-05-02 12:19:24 +0000
commite6a9e3c4ee39cc70a84a1572cdece4acdf069928 (patch)
tree8f03023e19d81b4e250eecf3a6426f85468fefd1 /man
parent33d553f83381fbdbbf75c2e008b4947a3abb5257 (diff)
downloadweston-e6a9e3c4ee39cc70a84a1572cdece4acdf069928.tar.gz
backend-drm: default to XRGB2101010 for HDR
Trying to do HDR with XRGB8888 is a bit like using RGB565 on SDR: you get visible color quantization and banding in gradients (without dithering which Weston does not implement yet, and might not work too well for HDR anyway). Therefore, on any HDR mode, default output framebuffer format to 10 bpc instead of 8 bpc. Ideally we'd also optionally try 16F or 16 bpc formats, but automatic fallbacks for those are more complicated to arrange. You can still configure 16F or 16 bpc manually. This patch also moves the default format setting from drm_output_set_gbm_format() to drm_output_enable(), because setting the default now requires eotf_mode. Frontends may call set_gbm_format() first and set eotf_mode next. This does create an awkward situation for outputs that a frontend disables and re-enables. This patch here makes sure that the old output configuration remains, but changing eotf_mode may not change the default format. One needs to call set_gbm_format(NULL) to re-evaluate the default format. Resetting the format on drm_output_deinit() would lose the current setting. DRM_FORMAT_INVALID was introduced in libdrm 2.4.95 which we already hard-depend on. Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
Diffstat (limited to 'man')
-rw-r--r--man/weston-drm.man7
1 files changed, 5 insertions, 2 deletions
diff --git a/man/weston-drm.man b/man/weston-drm.man
index 5947714c..48fd0c8e 100644
--- a/man/weston-drm.man
+++ b/man/weston-drm.man
@@ -57,7 +57,8 @@ 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.
+implementations. The names are case-insensitive. This setting applies only to
+.RB "outputs in SDR mode, see " eotf-mode " in " weston.ini (5).
.RB "If not specified, " xrgb8888 " is used. See also " gbm-format " in"
.BR output " section."
@@ -134,9 +135,11 @@ and possibly flipped. Possible values are
.TP
\fBgbm-format\fR=\fIformat\fR
Set the DRM KMS framebuffer format for this specific output. If not set,
-.RB "the value from " gbm-format " option in " core " section is used."
+.RB "the value from " gbm-format " option in " core " section is used"
+.RB "for SDR mode outputs and " xrgb2101010 " for other modes."
.RI "For the possible values for " format " see "
.BR gbm-format " option in " core " section."
+.RB "For SDR mode, see " eotf-mode " in " weston.ini (7).
.TP
\fBpixman-shadow\fR=\fIboolean\fR
If using the Pixman-renderer, use shadow framebuffers. Defaults to