From ed2e2894ab6b1743d8ba9b7334606a1648099050 Mon Sep 17 00:00:00 2001 From: wm4 Date: Wed, 12 Aug 2020 17:30:30 +0200 Subject: 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 --- DOCS/man/options.rst | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) (limited to 'DOCS') 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 -- cgit v1.2.3