summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-05-31 20:11:32 +0200
committerwm4 <wm4@nowhere>2019-09-19 20:37:05 +0200
commit165799157de1f688399356d25a7aebf695665c70 (patch)
tree480734481ee559980a6bd4d14b4b20bff9667d1a /DOCS
parente8a051b3cb3da739ff79cfa8450780a157374558 (diff)
downloadmpv-165799157de1f688399356d25a7aebf695665c70.tar.bz2
mpv-165799157de1f688399356d25a7aebf695665c70.tar.xz
vd_lavc: add --hwdec-extra-frames option
Surprised this didn't exist before.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 2e64966c85..8ccf3caa4f 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -1092,6 +1092,21 @@ Video
barely related to this anymore, but will be somewhat compatible in some
cases.
+``--hwdec-extra-frames=<N>``
+ Number of GPU frames hardware decoding should preallocate (default: see
+ ``--list-options`` output). If this is too low, frame allocation may fail
+ during decoding, and video frames might get dropped and/or corrupted.
+ Setting it too high simply wastes GPU memory and has no advantages.
+
+ This value is used only for hardware decoding APIs which require
+ preallocating surfaces (known examples include ``d3d11va`` and ``vaapi``).
+ For other APIs, frames are allocated as needed. The details depend on the
+ libavcodec implementations of the hardware decoders.
+
+ The required number of surfaces depends on dynamic runtime situations. The
+ default is a fixed value that is thought to be sufficient for most uses. But
+ in certain situations, it may not be enough.
+
``--hwdec-image-format=<name>``
Set the internal pixel format used by hardware decoding via ``--hwdec``
(default ``no``). The special value ``no`` selects an implementation