From 45b006b95868a90b2ecc21a56dfd7231cb7706bb Mon Sep 17 00:00:00 2001 From: Dudemanguy Date: Wed, 19 Jul 2023 16:12:47 -0500 Subject: DOCS: clarify screenshot window and screenshot-sw --- DOCS/man/input.rst | 3 +-- DOCS/man/options.rst | 9 +++++---- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 07a689106e..7f114dc8dd 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -369,8 +369,7 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_). behavior depends on the selected video output. Save the contents of the mpv window. Typically scaled, with OSD and - subtitles. The exact behavior depends on the selected video output, and - if no support is available, this will act like ``video``. + subtitles. The exact behavior depends on the selected video output. Take a screenshot each frame. Issue this command again to stop taking screenshots. Note that you should disable frame-dropping when using diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index fab91dd3d2..10c6ace9ae 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -4517,17 +4517,18 @@ Screenshot ``--screenshot-sw=`` Whether to use software rendering for screenshots (default: no). - If set to no, the screenshot will be rendered by the current VO if possible - (only vo_gpu currently). The advantage is that this will (probably) always + If set to no, the screenshot will be rendered by the current VO (only vo_gpu + or vo_gpu_next currently). The advantage is that this will (probably) always show up as in the video window, because the same code is used for rendering. But since the renderer needs to be reinitialized, this can be slow and - interrupt playback. (Unless the ``window`` mode is used with the - ``screenshot`` command.) + interrupt playback. If set to yes, the software scaler is used to convert the video to RGB (or whatever the target screenshot requires). In this case, conversion will run in a separate thread and will probably not interrupt playback. The software renderer may lack some capabilities, such as HDR rendering. + If ``window`` mode is used, the image will also be scaled in software + which may not accurately reflect the actual visible result. Software Scaler --------------- -- cgit v1.2.3