summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2020-08-12 17:30:30 +0200
committerwm4 <wm4@nowhere>2020-08-12 17:30:30 +0200
commited2e2894ab6b1743d8ba9b7334606a1648099050 (patch)
tree9abea001b3ef021459bfc394691ab147954e8742 /DOCS
parentcda8f1613ff307a9e0b5528743f3e941b05dcee7 (diff)
downloadmpv-ed2e2894ab6b1743d8ba9b7334606a1648099050.tar.bz2
mpv-ed2e2894ab6b1743d8ba9b7334606a1648099050.tar.xz
sub: extend range of --sub-pos option
Seems like this is requested all the time. It seems libass allows out of range values, but does allows the subtitle to go out of the screen at the bottom (only when moving it to the top it's "clamped"). Too bad, don't do that then. The bitmap sub rendering code on the other hand is under our control, and will not move a subtitle out of the screen. Fixes: #7986
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst16
1 files changed, 12 insertions, 4 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index ad7d449b33..12a482b062 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2223,14 +2223,22 @@ Subtitles
Use fonts embedded in Matroska container files and ASS scripts (default:
yes). These fonts can be used for SSA/ASS subtitle rendering.
-``--sub-pos=<0-100>``
+``--sub-pos=<0-150>``
Specify the position of subtitles on the screen. The value is the vertical
- position of the subtitle in % of the screen height.
+ position of the subtitle in % of the screen height. 100 is the original
+ position, which is often not the absolute bottom of the screen, but with
+ some margin between the bottom and the subtitle. Values above 100 move the
+ subtitle further down.
- .. note::
+ .. admonition:: Warning
+
+ Text subtitles (as opposed to image subtitles) may be cut off if the
+ value of the option is above 100. This is a libass restriction.
This affects ASS subtitles as well, and may lead to incorrect subtitle
- rendering. Use with care, or use ``--sub-margin-y`` instead.
+ rendering in addition to the problem above.
+
+ Using ``--sub-margin-y`` can achieve this in a better way.
``--sub-speed=<0.1-10.0>``
Multiply the subtitle event timestamps with the given value. Can be used