summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2020-04-13 15:55:51 +0200
committerwm4 <wm4@nowhere>2020-04-13 15:56:52 +0200
commitf6c81047fa5a9199084fa92327c41c6d8a16b059 (patch)
tree0df3a581b4f1d3e23a88e44ab53cae1e087c9bbb /DOCS
parente1e714ccc339c24b43179aa36f7f5f61865e2e98 (diff)
downloadmpv-f6c81047fa5a9199084fa92327c41c6d8a16b059.tar.bz2
mpv-f6c81047fa5a9199084fa92327c41c6d8a16b059.tar.xz
player: do not fall back to a default track with explicit selections
Consider e.g. --aid=2 with a file that has only 1 track. Then it would fall back to selecting track 1. Stop doing this. If no matching track is found, this will not select any track now. Note that the fingerprint stuff (track_layout_hash in the source) prevents softens the impact of this change. Without the fingerprint, playing a dual-audio file with the second track selected, and then a single-audio file, would play the second file without audio. But the fingerprint resets it due to differences in the track list. Try to exhaustively document this and tricky interactions between the other features. What a damn mess, I think it's simply cursed. Of course it's still my fault. See: #7608
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 347a6bbcc4..bd00d16fb4 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -76,6 +76,24 @@ Track Selection
before mpv 0.33.0, the user's track selection parameters are clobbered
in certain situations.
+ Also since mpv 0.33.0, trying to select a track by number will strictly
+ select this track. Before this change, trying to select a track which
+ did not exist would fall back to track default selection at playback
+ initialization. The new behavior is more consistent.
+
+ Setting a track selection property at runtime, and then playing a new
+ file might reset the track selection to defaults, if the fingerprint
+ of the track list of the new file is different.
+
+ Be aware of tricky combinations of all of all of the above: for example,
+ ``mpv --aid=2 file_with_2_audio_tracks.mkv file_with_1_audio_track.mkv``
+ would first play the correct track, and the second file without audio.
+ If you then go back the first file, its first audio track will be played,
+ and the second file is played with audio. If you do the same thing again
+ but instead of using ``--aid=2`` you run ``set aid 2`` while the file is
+ playing, then changing to the second file will play its audio track.
+ This is because runtime selection enables the fingerprint heuristic.
+
Most likely this is not the end.
``--sid=<ID|auto|no>``