path: root/DOCS
diff options
authorDan Oscarsson <>2017-02-01 13:19:09 +0100
committerwm4 <wm4@nowhere>2017-02-01 16:42:58 +0100
commitf1c9032ddf5eba1241d9616656b4c36bc4043283 (patch)
tree6c7e84dbca6d3631ac4330ed32987eb609deab8c /DOCS
parentbbf01346ff684f0f6a8cc8489b00920956dc16eb (diff)
sub: add justify of subtitles
To make it easier for the eyes, multi line subtitles should be left justified (for most languages). This adds an option to define how subtitles are to be justified inpendently of how they are aligned. Also add option to enable --sub-justify to be applied on ASS subtitles.
Diffstat (limited to 'DOCS')
2 files changed, 14 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 13b51ad4ba..3423d737ec 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -32,6 +32,8 @@ Interface changes
- "vo-drop-frame-count" to "frame-drop-count"
The old names still work, but are deprecated.
- remove the --stream-capture option and property. No replacement.
+ - add --sub-justify
+ - add --sub-ass-justify
--- mpv 0.23.0 ---
- remove deprecated vf_vdpaurb (use "--hwdec=vdpau-copy" instead)
- the following properties now have new semantics:
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index a6034e512e..1ad2f18b02 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -1976,6 +1976,18 @@ Subtitles
Vertical position (default: ``bottom``).
Details see ``--sub-align-x``.
+ Control how multi line subs are justified irrespective of where they
+ are aligned (default: ``auto`` which justifies as defined by
+ ``--sub-align-y``).
+ Left justification is recommended to make the subs easier to read
+ as it is easier for the eyes.
+ Applies justification as defined by ``--sub-justify`` on ASS subtitles
+ if ``--sub-ass-style-override`` is not set to ``no``.
+ Default: ``no``.
See ``--sub-color``. Color used for sub text shadow.