diff options
author | wm4 <wm4@nowhere> | 2013-01-30 01:17:33 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2013-01-30 23:41:22 +0100 |
commit | fd5637888ac5f6be60d2aac843afe5235930214a (patch) | |
tree | 920f640b19225493ed4eba8a8d1698f4ffec7d76 /DOCS/man/en/mpv.rst | |
parent | cfc3f10bda14e5ea42365776dc005e8f9cb09d64 (diff) | |
download | mpv-fd5637888ac5f6be60d2aac843afe5235930214a.tar.bz2 mpv-fd5637888ac5f6be60d2aac843afe5235930214a.tar.xz |
screenshot: minor simplification, prefer VF over VO
Remove screenshot_force and associated logic. Always try to use the
screenshot video filter before trying taking screenshots with the VO,
which means that --vf=screenshot now takes the role of --vf=screenshot_force.
(To make this clear, not adding a video filter is still the recommended
way to take screenshots; we just change how VF screenshots are forced.)
Preferring VO over VF and having --vf=screenshot_force used to make
sense when not all VOs supported screenshots, and some VOs had somewhat
broken screenshots (like vo_xv taking screenshots with OSD in it). But
all these issues are fixed now, so just get rid of the cruft.
Diffstat (limited to 'DOCS/man/en/mpv.rst')
-rw-r--r-- | DOCS/man/en/mpv.rst | 20 |
1 files changed, 7 insertions, 13 deletions
diff --git a/DOCS/man/en/mpv.rst b/DOCS/man/en/mpv.rst index 73d8b0a06b..d8fa642546 100644 --- a/DOCS/man/en/mpv.rst +++ b/DOCS/man/en/mpv.rst @@ -417,19 +417,13 @@ available number - no files will be overwritten. A screenshot will usually contain the unscaled video contents at the end of the video filter chain and subtitles. By default the ``S`` takes screenshots without -subtitles. Some video output drivers will always include subtitles and OSD in -the video frame as well - this is because of technical restrictions. - -The ``screenshot`` video filter is normally not required when using a -recommended GUI video output driver. The ``screenshot`` filter will be attempted -to be used if the video output doesn't support screenshots. Note that taking -screenshots with the video filter is not instant: the screenshot will be only -saved when the next video frame is displayed. This means attempting to take a -screenshot while the player is paused will do nothing, until the user unpauses -or seeks. Also, the screenshot filter is not compatible with hardware decoding, -and actually will cause initialization failure when use with hardware decoding -is attempted. Using the ``screenshot`` video filter is not recommended for -these reasons. +subtitles, while ``s`` includes subtitles. + +The ``screenshot`` video filter is not required when using a recommended GUI +video output driver. It should normally not be added to the config file, as +taking screenshots is handled by the VOs, and adding the screenshot filter will +break hardware decoding. (The filter may still be useful for taking screenshots +at a certain point within the video chain when using multiple video filters.) .. include:: changes.rst |