From 70df1608d6f74f3eba9a5e593822984194f63951 Mon Sep 17 00:00:00 2001 From: wm4 Date: Mon, 16 Nov 2015 22:47:17 +0100 Subject: 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.) --- DOCS/man/input.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'DOCS/man/input.rst') 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. -- cgit v1.2.3