summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-07-15 01:48:25 +0200
committerwm4 <wm4@nowhere>2013-07-15 02:01:37 +0200
commitaf55db654b9156879b89d92306a17fb847713792 (patch)
tree6c5b5fec75b0f5b5f8b49e56876d37fb43ef0774 /DOCS
parentcb8f638292457a6bcc8b1058a08fb6b6c2053f7b (diff)
downloadmpv-af55db654b9156879b89d92306a17fb847713792.tar.bz2
mpv-af55db654b9156879b89d92306a17fb847713792.tar.xz
sd_add: add terrible hack for (xy-)vsfilter compatibility
Much has been said about this topic, we don't need to say even more. See additions to options.rst.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 66cdadd120..ad463daffc 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -174,6 +174,31 @@
Enabled by default.
+``--ass-vsfilter-color-compat=<basic|full|force-601|no``
+ Mangle colors like (xy-)vsfilter do (default: basic). Historically, VSFilter
+ was not colorspace aware. This was no problem as long as the colorspace
+ used for SD video (BT.601) was used. But when everything switched to HD
+ (BT.709), VSFilter was still converting RGB colors to BT.601, rendered
+ them into the video frame, and handled the frame to the video output, which
+ would use BT.709 for conversion to RGB. The result were mangled subtitle
+ colors. Later on, bad hacks were added on top of the ASS format to control
+ how colors are to be mangled.
+
+ :basic: Handle only BT.601->BT.709 mangling, if the subtitles seem to
+ indicate that this is required (default).
+ :full: Handle the full ``YCbCr Matrix`` header with all video colorspaces
+ supported by libass and mpv. This might lead to bad breakages in
+ corner cases and is not strictly needed for compatibility
+ (hopefully), which is why this is not default.
+ :force-601: Force BT.601->BT.709 mangling, regardless of subtitle headers
+ or video colorspace.
+ :no: Disable color mangling completely. All colors are RGB.
+
+ Choosing anything other than ``no`` will make the subtitle color depend on
+ the video colorspace, and it's for example in theory not possible to reuse
+ a subtitle script with another video file. The ``--ass-style-override``
+ option doesn't affect how this option is interpreted.
+
``--audio-demuxer=<[+]name>``
Use this audio demuxer type when using ``--audiofile``. Use a '+' before the
name to force it; this will skip some checks. Give the demuxer name as