From 833375f88d0392cac49b30ee3a4704fbab58e814 Mon Sep 17 00:00:00 2001 From: wm4 Date: Wed, 4 May 2016 16:55:26 +0200 Subject: command: change some hwdec properties Introduce hwdec-current and hwdec-interop properties. Deprecate hwdec-detected, which never made a lot of sense, and which is replaced by the new properties. hwdec-active also becomes useless, as hwdec-current is a superset, so it's deprecated too (for now). --- DOCS/interface-changes.rst | 3 +++ DOCS/man/input.rst | 29 +++++++++++++++++++++++++++-- 2 files changed, 30 insertions(+), 2 deletions(-) (limited to 'DOCS') diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index d1d8d870e2..5ca7f19639 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -25,6 +25,9 @@ Interface changes point is unsert, and the end of the file for an unset B loop point - deprecate --sub-ass=no option by --ass-style-override=strip (also needs --embeddedfonts=no) + - add "hwdec-interop" and "hwdec-current" properties + - deprecated "hwdec-active" and "hwdec-detected" properties (to be removed + in mpv 0.19.0) --- mpv 0.17.0 --- - deprecate "track-list/N/audio-channels" property (use "track-list/N/demux-channel-count" instead) diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 83fddcf968..ea9eb07715 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1385,14 +1385,39 @@ Property list properties to see whether this was successful. Unlike in mpv 0.9.x and before, this does not return the currently active - hardware decoder. + hardware decoder. Since mpv 0.17.1, ``hwdec-current`` is available for + this purpose. + +``hwdec-current`` + Return the current hardware decoding in use. If decoding is active, return + one of the values used by the ``hwdec`` option/property. ``no`` indicates + software decoding. If no decoder is loaded, the property is unavailable. + +``hwdec-interop`` + This returns the currently loaded hardware decoding/output interop driver. + This is known only once the VO has opened (and possibly later). With some + VOs (like ``opengl``), this might be never known in advance, but only when + the decoder attempted to create the hw decoder successfully. (Using + ``--hwdec-preload`` can load it eagerly.) If there are multiple drivers + loaded, they will be separated by ``,``. + + If no VO is active or no interop driver is known, this property is + unavailable. + + This does not necessarily use the same values as ``hwdec``. There can be + multiple interop drivers for the same hardware decoder, depending on + platform and VO. ``hwdec-active`` + Deprecated. To be removed in mpv 0.19.0. Use ``hwdec-current`` instead. + Return ``yes`` or ``no``, depending on whether any type of hardware decoding is actually in use. ``hwdec-detected`` - If software decoding is active, this returns the hardware decoder in use. + Deprecated. To be removed in mpv 0.19.0. + + If hardware decoding is active, this returns the hardware decoder in use. Otherwise, it returns either ``no``, or if applicable, the currently loaded hardware decoding API. This is known only once the VO has opened (and possibly later). With some VOs (like ``opengl``), this is never known in -- cgit v1.2.3