From 6bfbd4ebdcadd5c94e4e47ba9712bf550293274f Mon Sep 17 00:00:00 2001 From: wm4 Date: Mon, 25 May 2015 21:44:48 +0200 Subject: command: change the hwdec properties Another very minor step towards property/option unification. Not bothering with interface compatibility here. --- DOCS/man/input.rst | 42 +++++++++++++++++++++++------------------- 1 file changed, 23 insertions(+), 19 deletions(-) (limited to 'DOCS/man/input.rst') diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 4806ac466e..75742d8062 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1246,25 +1246,29 @@ Property list See ``--hue``. ``hwdec`` (RW) - Return the current hardware decoder that is used. This uses the same values - as the ``--hwdec`` option. If software decoding is active, this returns - ``no``. You can write this property. Then the ``--hwdec`` option is set to - the new value, and video decoding will be reinitialized (internally, the - player will perform a seek to refresh the video properly). - - Note that you don't know the success of the operation immediately after - writing this property. It happens with a delay as video is reinitialized. - -``detected-hwdec`` - Return the current hardware decoder that was detected and opened. Returns - the same values as ``hwdec``. - - This is known only once the VO has opened (and possibly later). With some - VOs (like ``opengl``), this is never known in advance, but only when the - decoder attempted to create the hw decoder successfully. Also, hw decoders - with ``-copy`` suffix are returned only while hw decoding is active (and - unset afterwards). All this reflects how detecting hw decoders are - detected and used internally in mpv. + Reflects the ``--hwdec`` option. + + Writing to it may change the currently used hardware decoder, if possible. + (Internally, the player may reinitialize the decoder, and will perform a + seek to refresh the video properly.) You can watch the other hwdec + properties to see whether this was successful. + + Unlike in mpv 0.9.x and before, this does not return the currently active + hardware decoder. + +``hwdec-active`` + 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. + 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 + advance, but only when the decoder attempted to create the hw decoder + successfully. Also, hw decoders with ``-copy`` suffix will return ``no`` + while no video is being decoded. All this reflects how detecting hw decoders + are detected and used internally in mpv. ``panscan`` (RW) See ``--panscan``. -- cgit v1.2.3