diff options
author | wm4 <wm4@nowhere> | 2016-09-21 16:19:56 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2016-09-21 17:35:00 +0200 |
commit | 7783f0b7d7037e2420deece510b8315cfe3b8e91 (patch) | |
tree | 5d6aab943915187e36a6fb8488b4798feb9ace3c /DOCS | |
parent | 75d12c174f0b5bb03c71872241f965ac674221d7 (diff) | |
download | mpv-7783f0b7d7037e2420deece510b8315cfe3b8e91.tar.bz2 mpv-7783f0b7d7037e2420deece510b8315cfe3b8e91.tar.xz |
client API: more or less deprecate mpv_set_option()
With the merging of options and properties, the mpv_set_option()
function is close to being useless, and mpv_set_property() can be used
for everything instead. There are certain conflicts remaining, which are
explained in depth in the docs. For now, none of this should affect
existing code using the client API.
Make mpv_set_property() redirect to mpv_set_option() before
initialization.
Remove some options marked as M_OPT_FIXED. The "pause" and "speed"
options cannot be written anymore without the playloop being notified by
it, so the M_OPT_FIXED does nothing. For "vo-mmcss-profile", the problem
was lack of synchronization, which has been added. I'm not sure what the
problem was with "frames" - I think it was only marked as M_OPT_FIXED
because changing it during playback will have no effect. Except for
pause/speed, these changes are needed to make them writable as
properties after mpv_initialize().
Also replace all remaining uses of CONF_GLOBAL with M_OPT_FIXED.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/client-api-changes.rst | 9 | ||||
-rw-r--r-- | DOCS/interface-changes.rst | 2 |
2 files changed, 10 insertions, 1 deletions
diff --git a/DOCS/client-api-changes.rst b/DOCS/client-api-changes.rst index c76881fbd4..2a9371055a 100644 --- a/DOCS/client-api-changes.rst +++ b/DOCS/client-api-changes.rst @@ -39,6 +39,15 @@ API changes workaround for the FFmpeg TLS code, which has been fixed long ago. - deprecate mpv_suspend() and mpv_resume(). They will be stubbed out in mpv 0.22.0. + - make mpv_set_property() work to some degree before mpv_initialize(). + It can now be used instead of mpv_set_option(). + - semi-deprecate mpv_set_option()/mpv_set_option_string(). You should + use mpv_set_property() instead. There are some deprecated properties + which conflict with some options (see client.h remarks on + mpv_set_option()), for which mpv_set_option() might still be required. + In future mpv releases, the conflicting deprecated options/properties + will be removed, and mpv_set_option() will internally translate API + calls to mpv_set_property(). --- mpv 0.19.0 --- 1.22 - add stream_cb API for custom protocols --- mpv 0.18.1 --- diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index ae0d23a884..d32203ccb5 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -58,7 +58,7 @@ Interface changes - "fps" -> "container-fps" - "idle" -> "idle-active" - "cache" -> "cache-percent" - the old names are deprecated + the old names are deprecated and will change behavior in mpv 0.22.0. - remove deprecated "hwdec-active" and "hwdec-detected" properties - deprecate the ao and vo auto-profiles (they never made any sense) - deprecate "--vo=direct3d_shaders" - use "--vo=direct3d" instead. |