summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorDudemanguy <random342@airmail.cc>2023-09-01 21:54:41 -0500
committerDudemanguy <random342@airmail.cc>2023-09-09 02:48:53 +0000
commitfe875083b3d30b06ef77745f40570e8f63afec2b (patch)
tree4e57179e96e7815ce6d3d2a0990050adc5501395 /DOCS
parentbda84399ab363d3ac5e79fcf6eaa40fcb60f32ae (diff)
downloadmpv-fe875083b3d30b06ef77745f40570e8f63afec2b.tar.bz2
mpv-fe875083b3d30b06ef77745f40570e8f63afec2b.tar.xz
player: redo --subs-fallback-forced
In the never ending quest of trying to satisfy every possible user request for subtitle autoselection, I ended up redoing how --subs-fallback-forced works. The old behavior had it as strictly a fallback-type option when there were no lang matches, but now we can make it an active part of compare_track and it works along with slang to select the desired track. Since it's a three state option, the no option still works to avoid selecting any forced subtitle tracks. The meaning of always slightly changes to mean "only select forced subtitle tracks" and yes remains essentially the same (no special priority given besides the audio matching subtitle language case).
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst9
2 files changed, 6 insertions, 4 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index a738685095..87a18722ea 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -57,6 +57,7 @@ Interface changes
- add `video-params/crop-[w,h,x,y]`
- remove `--tone-mapping-mode`
- add `auto` to `--sub-fix-timing` and make it the default
+ - change `--subs-fallback-forced` so that it works alongside `--slang`
--- mpv 0.36.0 ---
- add `--target-contrast`
- Target luminance value is now also applied when ICC profile is used.
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index a545947fe9..e8790a4672 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -153,10 +153,11 @@ Track Selection
Setting this to `default` means that only streams flagged as `default` will be selected.
``--subs-fallback-forced=<yes|no|always>``
- When autoselecting a subtitle track, if no tracks match your preferred languages,
- select a forced track that matches the language of the selected audio track (default: yes).
- `always` will always select a forced track if possible, regardles if the language matches the
- selected audio track or not.
+ When autoselecting a subtitle track, the default value of `yes` will prefer using a forced
+ subtitle track if the subtitle language matches the audio language and matches your list of
+ preferred languages. The special value `always` will only select forced subtitle tracks and
+ never fallback on a non-forced track. Conversely, `no` will never select a forced subtitle
+ track.
Playback Control