From e8126e54e51d0ed8c052bf8733df5519d003e464 Mon Sep 17 00:00:00 2001 From: Dudemanguy Date: Sat, 22 Jul 2023 16:01:14 -0500 Subject: [PATCH] DOCS/vo: clarify dmabuf-wayland a bit Make it clearer that you should be using --hwdec with this VO. Also make some comments about the things that are required for this to work correctly (i.e. working drivers/GPU and the right compositor). --- DOCS/man/vo.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst index dccfa62a7c..0592d9467e 100644 --- a/DOCS/man/vo.rst +++ b/DOCS/man/vo.rst @@ -291,8 +291,12 @@ Available video output drivers are: or VA API hardware decoding. The driver is designed to avoid any GPU to CPU copies, and to perform scaling and color space conversion using fixed-function hardware, if available, rather than GPU shaders. This frees up GPU resources for other tasks. - Currently this driver is experimental and only works with the ``--hwdec=vaapi`` - or ``hwdec=drm`` drivers. Supported compositors : Weston and Sway. + It is highly recommended to use this VO with the appropriate ``--hwdec`` option such + as ``auto-safe``. It can still work in some circumstances without ``--hwdec`` due to + mpv's internal conversion filters, but this is not recommended as it's a needless + extra step. Correct output depends on support from your GPU, drivers, and compositor. + Weston and wlroots-based compositors like Sway and Intel GPUs are known to generally + work. ``vaapi`` Intel VA API video output driver with support for hardware decoding. Note