summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorsfan5 <sfan5@live.de>2023-01-21 15:45:11 +0100
committerNiklas Haas <github-daiK1o@haasn.dev>2023-01-23 14:13:34 +0100
commitc7ea0cd68f2cd68edea2f64060c1bcb483005a50 (patch)
tree7d52e83db2da101d36fa19884f9c0cf1740e9651 /DOCS
parentf8c17f55f975ea3b46ba7cea299f1a8e5d980b4c (diff)
downloadmpv-c7ea0cd68f2cd68edea2f64060c1bcb483005a50.tar.bz2
mpv-c7ea0cd68f2cd68edea2f64060c1bcb483005a50.tar.xz
vd_lavc: add "auto" choice for vd-lavc-dr
--vd-lavc-dr defaulted to "yes", which caused issues on certain hardware. Instead of disabling it, add a new "auto" value and make it the default. The "auto" choice will enable DR only when we can request host-cached buffers (as signalled by the new VO_DR_FLAG_HOST_CACHED). Co-authored-by: Nicolas F. <ovdev@fratti.ch> Co-authored-by: Niklas Haas <git@haasn.dev>
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst8
2 files changed, 7 insertions, 2 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 6644638b29..6177d09a40 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -45,6 +45,7 @@ Interface changes
watch-later. It is still written by default but you may
need to explictly add `start` depending on how you have
`--watch-later-options` configured.
+ - add `--vd-lavc-dr=auto` and make it the default
--- mpv 0.35.0 ---
- add the `--vo=gpu-next` video output driver, as well as the options
`--allow-delayed-peak-detect`, `--builtin-scalers`,
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 3b2e2d1bf5..7e99b2a5d5 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -1700,8 +1700,8 @@ Video
support this, then it will be treated as ``cpu``, regardless of the setting.
Currently, only ``gpu-next`` supports film grain application.
-``--vd-lavc-dr=<yes|no>``
- Enable direct rendering (default: yes). If this is set to ``yes``, the
+``--vd-lavc-dr=<auto|yes|no>``
+ Enable direct rendering (default: auto). If this is set to ``yes``, the
video will be decoded directly to GPU video memory (or staging buffers).
This can speed up video upload, and may help with large resolutions or
slow hardware. This works only with the following VOs:
@@ -1709,6 +1709,10 @@ Video
- ``gpu``: requires at least OpenGL 4.4 or Vulkan.
- ``libmpv``: The libmpv render API has optional support.
+ The ``auto`` option will try to guess whether DR can improve performance
+ on your particular hardware. Currently this enables it on AMD or NVIDIA
+ if using OpenGL or unconditionally if using Vulkan.
+
Using video filters of any kind that write to the image data (or output
newly allocated frames) will silently disable the DR code path.