From 48ce438fae94805cf164e29c6bc6f529b33b87d2 Mon Sep 17 00:00:00 2001 From: nanahi <130121847+na-na-hi@users.noreply.github.com> Date: Wed, 3 Apr 2024 20:42:07 -0400 Subject: [PATCH] DOCS/man/options: mention the impact of --hwdec-codecs on startup time Probing for hwdec can be very slow: on my setup (Nvidia GPU without VP9 hwdec capability), this causes 2x hot cache startup time compared to explicitly disabling VP9 in this list (500 ms -> 1 000 ms). Also remove --vo=vdpau reference. --- DOCS/man/options.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index a731d3116e..1ffecdf51d 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -1730,9 +1730,16 @@ Video This is usually only needed with broken GPUs, where a codec is reported as supported, but decoding causes more problems than it solves. + .. note:: + + On some broken drivers (e.g. NVIDIA on Linux), probing for codecs which + the GPU does not support can unnecessarily slow down video playback + initialization. To alleviate this, explicitly specify a list which + only includes the codecs supported on the setup. + .. admonition:: Example - ``mpv --hwdec=vdpau --vo=vdpau --hwdec-codecs=h264,mpeg2video`` + ``mpv --hwdec=vdpau --hwdec-codecs=h264,mpeg2video`` Enable vdpau decoding for h264 and mpeg2 only. ``--vd-lavc-check-hw-profile=``