From 165799157de1f688399356d25a7aebf695665c70 Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 31 May 2019 20:11:32 +0200 Subject: vd_lavc: add --hwdec-extra-frames option Surprised this didn't exist before. --- DOCS/man/options.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'DOCS/man/options.rst') 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=`` + 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=`` Set the internal pixel format used by hardware decoding via ``--hwdec`` (default ``no``). The special value ``no`` selects an implementation -- cgit v1.2.3