summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2024-01-21 20:37:47 -0600
committerDudemanguy <random342@airmail.cc>2024-02-07 14:50:09 +0000
commit8dbbc2ad82d6ebfa986db4726e2e5006b7cb0a9d (patch)
treec9dd1bfe83ed3141275e7bf560214200e0322305 /DOCS/man/options.rst
parent9ce2bafbe9a49afe65eb86b46625f12dcb1b3110 (diff)
downloadmpv-8dbbc2ad82d6ebfa986db4726e2e5006b7cb0a9d.tar.bz2
mpv-8dbbc2ad82d6ebfa986db4726e2e5006b7cb0a9d.tar.xz
player: add an auto option to deinterlace
Deinterlacing required that the user set it on/off themselves, but we actually have handy flags for detecting if a frame is interlaced. So it's pretty simple to make an auto option using that. Unfortunately, life is not quite that simple and there are known cases of false positives from the ffmpeg flags so we can't make auto the default value. However, it still may have some utility for some people, and the detection could potentially be improved upon later. Closes #10358.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst19
1 files changed, 9 insertions, 10 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index e3b49b4087..ebe99cb189 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -1659,23 +1659,22 @@ Video
Works in ``--no-correct-pts`` mode only.
-``--deinterlace=<yes|no>``
+``--deinterlace=<yes|no|auto>``
Enable or disable interlacing (default: no).
Interlaced video shows ugly comb-like artifacts, which are visible on
fast movement. Enabling this typically inserts the bwdif video filter in
order to deinterlace the video, or lets the video output apply deinterlacing
if supported.
- This behaves exactly like the ``deinterlace`` input property (usually
- mapped to ``d``).
+ When using ``auto``, mpv will insert a deinterlacing filter if ffmpeg
+ detects that the video frame is interlaced. Be aware that there can be false
+ positives in certain cases, such as when files are encoded as interlaced
+ despite the video not actually being so. This is why ``auto`` is not the
+ default value.
- Keep in mind that this **will** conflict with manually inserted
- deinterlacing filters, unless you take care. (Since mpv 0.27.0, even the
- hardware deinterlace filters will conflict. Also since that version,
- ``--deinterlace=auto`` was removed, which used to mean that the default
- interlacing option of possibly inserted video filters was used.)
-
- Note that this will make video look worse if it's not actually interlaced.
+ Keep in mind that using this filter **will** conflict with any manually
+ inserted deinterlacing filters, and that this will make video look worse if
+ it's not actually interlaced.
``--frames=<number>``
Play/convert only first ``<number>`` video frames, then quit.