From f1f091759a84cc8ca509f6af639e03b7a8e01405 Mon Sep 17 00:00:00 2001 From: nanahi <130121847+na-na-hi@users.noreply.github.com> Date: Sun, 15 Sep 2024 11:56:03 -0400 Subject: [PATCH] DOCS/man/options.rst: clarify sub-ass-use-video-data a bit --- DOCS/man/options.rst | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 8f000b6cea..555edd3dc6 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -2570,7 +2570,17 @@ Subtitles ``--sub-ass-use-video-data=`` Controls which information about the video stream is passed to libass. - Any option but ``all`` is incompatible with standard ASS and VSFilters. + Any option but ``all`` is incompatible with VSFilter, whose behavior + most subtitle scripts and renderers target, including libass. + Aspect ratio and storage resolution information are needed for VSFilter + compatibility, and withholding them will likely result in broken subtitle + rendering for most files. It's thus recommended to only use ``none`` or + ``aspect-ratio`` on a per-file basis. + + :nono: Don't use aspect ratio or storage resolution. + :aspect-ratio: Use aspect ratio only. Resolutions specified in the script + are used in place of storage resolution. + :all: Use both aspect ratio and storage resolution. For certain kinds of broken ASS files which got repurposed across several video resolutions without either setting ``LayoutRes`` headers @@ -2589,7 +2599,7 @@ Subtitles Allows passing any arbitrary aspect ratio to libass instead of the video’s actual aspect ratio. Zero or negative aspect ratios are identical to ``no``. - This has no effect if ``sub-ass-use-video-data`` is set to none. + This has no effect if ``sub-ass-use-video-data`` is set to ``none``. ``--sub-vsfilter-bidi-compat=`` Set implicit bidi detection to ``ltr`` instead of ``auto`` to match ASS'