diff options
author | wm4 <wm4@nowhere> | 2016-08-17 22:45:44 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2016-08-17 22:46:48 +0200 |
commit | f5bbb5aed22f9c52ce078522dc3da6a9403e8a9d (patch) | |
tree | a37070ada1f37719257197e1551074ded8b38513 /DOCS | |
parent | 07f8b647547cadb61d0677200faeaf1498b8377e (diff) | |
download | mpv-f5bbb5aed22f9c52ce078522dc3da6a9403e8a9d.tar.bz2 mpv-f5bbb5aed22f9c52ce078522dc3da6a9403e8a9d.tar.xz |
player: add option to control duration of image display
The --image-display-duration option controls how long an image is
displayed. It's also possible to display the image forever (until manual
user interaction stops playback).
With this, the core drops the old method to "drain" video (i.e. waiting
for the last frame duration on end of playback). Instead, we reuse
MPContext.time_frame. The old mechanism was disabled for non-images
anyway.
Fixes #3425.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/interface-changes.rst | 4 | ||||
-rw-r--r-- | DOCS/man/options.rst | 17 |
2 files changed, 21 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index d7db0106b4..f02f6588ff 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -19,6 +19,10 @@ Interface changes :: + --- mpv 0.20.0 --- + - add --image-display-duration option - this also means that image duration + is not influenced by --mf-fps anymore in the general case (this is an + incompatible change) --- mpv 0.19.0 --- - deprecate "balance" option/property (no replacement) --- mpv 0.18.1 --- diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 39416d2a64..0301e6971d 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -1873,6 +1873,23 @@ Window file.mkv normally, then fail to open ``/dev/null``, then exit). (In mpv 0.8.0, ``always`` was introduced, which restores the old behavior.) +``--image-display-duration=<seconds|inf>`` + If the current file is an image, play the image for the given amount of + seconds (default: 1). ``inf`` means the file is kept open forever (until + the user stops playback manually). + + Unlike ``--keep-open``, the player is not paused, but simply continues + playback until the time has elapsed. (It should not use any resources + during "playback".) + + This affects image files, which are defined as having only 1 video frame + and no audio. The player may recognize certain non-images as images, for + example if ``--length`` is used to reduce the length to 1 frame, or if + you seek to the last frame. + + This option does not affect the framerate used for ``mf://`` or + ``--merge-files``. For that, use ``--mf-fps`` instead. + ``--force-window=<yes|no|immediate>`` Create a video output window even if there is no video. This can be useful when pretending that mpv is a GUI application. Currently, the window |