RepoMirrors
/
mpv
mirror of https://github.com/mpv-player/mpv
1
0
Fork 0
Code Issues Releases Wiki Activity

DOCS/man/options.rst: further tweak sub-ass-use-video-data description

This commit is contained in:
Oneric 2024-09-18 23:54:50 +02:00 committed by Dudemanguy
parent 284293ceb5
commit 7431896cd1
1 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
DOCS/man/options.rst
View File

@ -2570,17 +2570,16 @@ Subtitles
``--sub-ass-use-video-data=<none|aspect-ratio|all>`` ``--sub-ass-use-video-data=<none|aspect-ratio|all>``
Controls which information about the video stream is passed to libass. Controls which information about the video stream is passed to libass.
Any option but ``all`` is incompatible with VSFilter, whose behavior Any option but ``all`` is incompatible with standard ASS as defined by VSFilter,
most subtitle scripts and renderers target, including libass. whose behavior most subtitle scripts and renderers target, including libass.
Aspect ratio and storage resolution information are needed for VSFilter Video stream properties are needed to accurately emulate VSFilter semantics and
compatibility, and withholding them will likely result in broken subtitle withholding them will likely result in broken subtitle rendering for most files.
rendering for most files. It's thus recommended to only use ``none`` or It's thus recommended to only change this selectively if required on a per-file basis.
``aspect-ratio`` on a per-file basis.
:none: Don't use aspect ratio or storage resolution. :none: Don't forward any video stream information.
:aspect-ratio: Use aspect ratio only. Resolutions specified in the script :aspect-ratio: Only forward aspect ratio; fallbacks are used for other properties.
are used in place of storage resolution. This makes behaviour consistent across different video resolutions.
:all: Use both aspect ratio and storage resolution. :all: Forward all available information, notably including storage resolution.
For certain kinds of broken ASS files which got repurposed across For certain kinds of broken ASS files which got repurposed across
several video resolutions without either setting ``LayoutRes`` headers several video resolutions without either setting ``LayoutRes`` headers