0
0
mirror of https://github.com/mpv-player/mpv.git synced 2024-09-19 19:42:24 +02:00

DOCS/man/options.rst: clarify sub-ass-use-video-data a bit

This commit is contained in:
nanahi 2024-09-15 11:56:03 -04:00 committed by Kacper Michajłow
parent d245e9dc8c
commit f1f091759a

View File

@ -2570,7 +2570,17 @@ Subtitles
``--sub-ass-use-video-data=<none|aspect-ratio|all>``
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 videos
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=<yes|no>``
Set implicit bidi detection to ``ltr`` instead of ``auto`` to match ASS'