mpv/DOCS/man
Philip Langdale 61e685594d hwdec_vulkan: add Vulkan HW Interop
Vulkan Video Decoding has finally become a reality, as it's now
showing up in shipping drivers, and the ffmpeg support has been
merged.

With that in mind, this change introduces HW interop support for
ffmpeg Vulkan frames. The implementation is functionally complete - it
can display frames produced by hardware decoding, and it can work with
ffmpeg vulkan filters. There are still various caveats due to gaps and
bugs in drivers, so YMMV, as always.

Primary testing has been done on Intel, AMD, and nvidia hardware on
Linux with basic Windows testing on nvidia.

Notable caveats:
* Due to driver bugs, video decoding on nvidia does not work right now,
  unless you use the Vulkan Beta driver. It can be worked around, but
  requires ffmpeg changes that are not considered acceptable to merge.
* Even if those work-arounds are applied, Vulkan filters will not work
  on video that was decoded by Vulkan, due to additional bugs in the
  nvidia drivers. The filters do work correctly on content decoded some
  other way, and then uploaded to Vulkan (eg: Decode with nvdec, upload
  with --vf=format=vulkan)
* Vulkan filters can only be used with drivers that support
  VK_EXT_descriptor_buffer which doesn't include Intel ANV as yet.
  There is an MR outstanding for this.
* When dealing with 1080p content, there may be some visual distortion
  in the bottom lines of frames due to chroma scaling incorporating the
  extra hidden lines at the bottom of the frame (1080p content is
  actually stored as 1088 lines), depending on the hardware/driver
  combination and the scaling algorithm. This cannot be easily
  addressed as the mechanical fix for it violates the Vulkan spec, and
  probably requires a spec change to resolve properly.

All of these caveats will be fixed in either drivers or ffmpeg, and so
will not require mpv changes (unless something unexpected happens)

If you want to run on nvidia with the non-beta drivers, you can this
ffmpeg tree with the work-around patches:

* https://github.com/philipl/FFmpeg/tree/vulkan-nvidia-workarounds
2023-05-28 15:46:05 -07:00
..
af.rst various: remove trailing whitespace 2022-05-14 14:51:34 +00:00
ao.rst ao_pipewire: clarify --pipewire-buffer=native 2023-04-23 21:03:58 -07:00
changes.rst
console.rst console.lua: add a script-opt for the border size 2023-04-26 16:30:01 +00:00
encode.rst
input.rst meson: use the new build_options method 2023-04-11 20:05:36 +00:00
ipc.rst DOCS: Add missing 'not' 2023-01-28 11:59:59 -05:00
javascript.rst lua/js: remove user-data helpers 2023-01-29 01:52:31 +02:00
libmpv.rst DOCS/libmpv: fix typo in linkage section 2022-09-03 12:54:48 -04:00
lua.rst DOCS/lua: fix typo 2023-03-21 15:49:42 +02:00
mpv.rst player: use XDG_CACHE_HOME by default 2023-05-09 20:37:17 +00:00
options.rst hwdec_vulkan: add Vulkan HW Interop 2023-05-28 15:46:05 -07:00
osc.rst various: fix various typos in the code base 2023-03-28 19:29:44 +00:00
stats.rst
vf.rst hwdec_vulkan: add Vulkan HW Interop 2023-05-28 15:46:05 -07:00
vo.rst vo_kitty: Introduce modern sixel alternative 2022-12-21 19:39:30 +01:00