summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2016-03-09 23:34:04 +0100
committerwm4 <wm4@nowhere>2016-03-09 23:34:04 +0100
commit7387766445f7aae47a4e8095128ea9b688299091 (patch)
tree83e42ba5c0e647a2b3b5ba4a231435f2d55bb2be /DOCS
parent95ca308d4494fc010802ed79fad5a9f85d9a5730 (diff)
downloadmpv-7387766445f7aae47a4e8095128ea9b688299091.tar.bz2
mpv-7387766445f7aae47a4e8095128ea9b688299091.tar.xz
command: change stream-pos semantics
Changing the byte stream position without cooperation of the demuxer seems a bit insane, and is certainly useless. A user should do factor seeks instead. For formats like ts, this will actually translate to byte seeks, while treating the rest of the playback chain a bit more gracefully. With this argument, remove write access to this property. If someone really complains, proper byte seeks could be added as seek mode (although I'm going to need a convincing argument for this). Read access changes too, but in a more subtle way.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/input.rst5
2 files changed, 4 insertions, 2 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 1298c24d6d..377d3efbb0 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -22,6 +22,7 @@ Interface changes
--- mpv 0.17.0 ---
- deprecate "track-list/N/audio-channels" property (use
"track-list/N/demux-channel-count" instead)
+ - remove write access to "stream-pos", and change semantics for read access
--- mpv 0.16.0 ---
- change --audio-channels default to stereo (use --audio-channels=auto to
get the old default)
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 0cdb611583..8aafadbf81 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -921,8 +921,9 @@ Property list
useless. It looks like this can be different from ``path`` only when
using e.g. ordered chapters.)
-``stream-pos`` (RW)
- Raw byte position in source stream.
+``stream-pos``
+ Raw byte position in source stream. Technically, this returns the position
+ of the most recent packet passed to a decoder.
``stream-end``
Raw end position in bytes in source stream.