diff options
| author | wm4 <wm4@nowhere> | 2015-11-16 22:47:17 +0100 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2015-11-16 22:47:17 +0100 |
| commit | 70df1608d6f74f3eba9a5e593822984194f63951 (patch) | |
| tree | e6f332aa72d8fd8020d4ba9a214a4826ed6e711f /DOCS/man/input.rst | |
| parent | e24e0ccd6828ff8a50fb290bed45a0f6d81eb00b (diff) | |
| download | mpv-70df1608d6f74f3eba9a5e593822984194f63951.tar.bz2 mpv-70df1608d6f74f3eba9a5e593822984194f63951.tar.xz | |
player: handle rebasing start time differently
Most of this is explained in the DOCS additions.
This gives us slightly more sanity, because there is less interaction
between the various parts. The goal is getting rid of the video_offset
entirely.
The simplification extends to the user API. In particular, we don't need
to fix missing parts in the API, such as the lack for a seek command
that seeks relatively to the start time. All these things are now
transparent.
(If someone really wants to know the real timestamps/start time, new
properties would have to be added.)
Diffstat (limited to 'DOCS/man/input.rst')
| -rw-r--r-- | DOCS/man/input.rst | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 0233dbf057..b581c5a8ad 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -943,8 +943,9 @@ Property list Position in current file in seconds. ``time-start`` - Return the start time of the file. (Usually 0, but some kind of files, - especially transport streams, can have a different start time.) + Deprecated. Always returns 0. Before mpv 0.14, this used to return the start + time of the file (could affect e.g. transport streams). See + ``--rebase-start-time`` option. ``time-remaining`` Remaining length of the file in seconds. Note that the file duration is not @@ -954,9 +955,11 @@ Property list ``time-remaining`` scaled by the current ``speed``. ``playback-time`` (RW) - The playback time, which is the time relative to playback start. (This can - be different from the ``time-pos`` property if the file does not start at - position ``0``, in which case ``time-pos`` is the source timestamp.) + Position in current file in seconds. Unlike ``time-pos``, the time is + clamped to the range of the file. (Inaccurate file durations etc. could + make it go out of range. Also helpful when the user attempts to seek + outside of the file, as the seek target time is considered the current + position during seeking.) ``chapter`` (RW) Current chapter number. The number of the first chapter is 0. |