summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-08-03 20:25:03 +0200
committerwm4 <wm4@nowhere>2014-08-03 20:31:00 +0200
commit0f5aed9c62cb29a53dc1039df786207a2bd80d85 (patch)
tree1f307ee9f2b62d47b12ee9fb8cc487d9f41cd005 /DOCS
parent0ddbf92d067e342ef58fbd60e1c4871feba83ea5 (diff)
downloadmpv-0f5aed9c62cb29a53dc1039df786207a2bd80d85.tar.bz2
mpv-0f5aed9c62cb29a53dc1039df786207a2bd80d85.tar.xz
player: some further playloop cleanups
Handle --term-playing-msg at a better place. Move MPV_EVENT_TICK hack into a separate function. Also add some words to the client API that you shouldn't use it. (But better leave breaking it for later.) Handle --frames and frame_step differently. Remove the mess from the playloop, and do it after frame display. Give up on the weird semantics for audio-only mode (they didn't make sense anyway), and adjust the manpage accordingly.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/input.rst2
-rw-r--r--DOCS/man/options.rst13
2 files changed, 9 insertions, 6 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 04c1dc16fb..dd20d825fc 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -106,7 +106,7 @@ List of Input Commands
``revert_seek`` command itself.
``frame_step``
- Play one frame, then pause.
+ Play one frame, then pause. Does nothing with audio-only playback.
``frame_back_step``
Go back by one frame, then pause. Note that this can be very slow (it tries
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index e3cef52f99..17257844b5 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -919,11 +919,14 @@ OPTIONS
Practical use of this feature is questionable. Disabled by default.
``--frames=<number>``
- Play/convert only first ``<number>`` video frames, then quit. For audio
- only, run ``<number>`` iteration of the playback loop, which is most likely
- not what you want. (This behavior also applies to the corner case when there
- are fewer video frames than ``<number>``, and audio is longer than the
- video.)
+ Play/convert only first ``<number>`` video frames, then quit.
+
+ ``--frames=0`` loads the file, but immediately quits before initializing
+ playback. (Might be useful for scripts which just want to determine some
+ file properties.)
+
+ For audio-only playback, any value greater than 0 will quit playback
+ immediately after initialization. The value 0 works as with video.
``--fullscreen``, ``--fs``
Fullscreen playback.