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/interface-changes.rst | 5 +++++ DOCS/man/input.rst | 42 +++++++++++++++++++++++------------------- 2 files changed, 28 insertions(+), 19 deletions(-) (limited to 'DOCS') diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index aff7aa2926..5e773ba5f2 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -20,6 +20,11 @@ Interface changes :: --- mpv 0.10.0 will be released --- + - completely change how the hwdec properties work: + - "hwdec" now reflects the --hwdec option + - "hwdec-detected" does partially what the old "hwdec" property did + (and also, "detected-hwdec" is removed) + - "hwdec-active" is added - add protocol-list property - deprecate audio-samplerate and audio-channels properties (audio-params sub-properties are the replacement) 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