summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2012-10-11 02:23:29 +0200
committerwm4 <wm4@nowhere>2012-10-12 10:13:42 +0200
commitc9df2c8bd83b31375a79ab2bc4f854a53ff019c1 (patch)
tree033bb4a08d8aa13ab8ccec05ccae4588531637f0 /DOCS/man/en/options.rst
parent2f6713bedeb77a7c058ce4954eb95ee7a2ca7119 (diff)
downloadmpv-c9df2c8bd83b31375a79ab2bc4f854a53ff019c1.tar.bz2
mpv-c9df2c8bd83b31375a79ab2bc4f854a53ff019c1.tar.xz
sub: add --ass-style-override option to disable style overrides
There are a number of options which modify ASS subtitle rendering. Most of these do things that can interfere with the styling done by subtitle scripts, resulting in incorrect rendering. Add the --ass-style-override option to make it easy to disable all overrides. This helps trouble- shooting, and makes it more practical to use the override features. (You can simply toggle the ass-style-override property at runtime, should one of the style override options break subtitle rendering at a certain point.) This mainly affects whether most --ass-* options are applied, as well as --sub-pos. Some things, like explicit style overrides loaded with --ass-force-style, can't be changed at runtime using the ass-style-override property.
Diffstat (limited to 'DOCS/man/en/options.rst')
-rw-r--r--DOCS/man/en/options.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 875b9c4b4a..6151e0d21a 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -176,6 +176,14 @@
rendering text subtitles. The syntax of the file is exactly like the ``[V4
Styles]`` / ``[V4+ Styles]`` section of SSA/ASS.
+--ass-style-override=<yes|no>
+ Control whether user style overrides should be applied.
+
+ :yes: Apply all the ``--ass-*`` style override options. Changing the default
+ for any of these options can lead to incorrect subtitle rendering.
+ (Default.)
+ :no: Render subtitles as forced by subtitle scripts.
+
--ass-top-margin=<value>
Adds a black band at the top of the frame. The SSA/ASS renderer can place
toptitles there (with ``--ass-use-margins``).