diff options
| author | wm4 <wm4@nowhere> | 2020-03-21 17:08:43 +0100 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2020-03-21 19:32:50 +0100 |
| commit | e9e93b4dbe748cd341a6fbea355e6ba013ada81b (patch) | |
| tree | ae548b385123e620adf4432f3ab4666f425874c7 /DOCS/interface-changes.rst | |
| parent | 68d9d11ddf2817b682b0a9f87d4d42791d5666ca (diff) | |
| download | mpv-e9e93b4dbe748cd341a6fbea355e6ba013ada81b.tar.bz2 mpv-e9e93b4dbe748cd341a6fbea355e6ba013ada81b.tar.xz | |
player: add a number of new playlist contol commands/properties
Should give a good deal more explicit control and insight over the
player state.
Some feel a bit pointless, and/or expose internal weirdness. However,
it's not like the existing weirdness didn't exist before, or can be made
go away. (In part, the weirdness is because certain in-between states
are visible. Hiding them would make things simpler, but less flexible.)
Maybe this actually gives users a better idea how the API _should_ look
like, too.
On a side note, this tries to really guarantee that mpctx->playing is
set between playback start/end. For that, the loadfile.c changes assume
that mpctx->playing is set (guaranteed by code above the change), and
that playing->filename is set (probably could never be false; was broken
before and actually would have crashed if that could ever happen; in any
case, also add an assert to playlist.c for this).
playlist_entry_to_index() now tolerates playlist_entrys that are not
part of the playlist. This is also needed for mpctx->playing.
Diffstat (limited to 'DOCS/interface-changes.rst')
| -rw-r--r-- | DOCS/interface-changes.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index c63669ad7c..15be443190 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -48,6 +48,12 @@ Interface changes - the playlist-pos and playlist-pos-1 properties now can return and accept -1, and are never unavailable. Out of range indexes are now accepted, but behave like writing -1. + - the playlist-pos and playlist-pos-1 properties deprecate the current + behavior when writing back the current value to the property: currently, + this restarts playback, but in the future, it will do nothing. + Using the "playlist-play-index" command is recommended instead. + - add "playlist-play-index" command + - add playlist-current-pos, playlist-playing-pos properties --- mpv 0.32.0 --- - change behavior when using legacy option syntax with options that start with two dashes (``--`` instead of a ``-``). Now, using the recommended |