summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-06-08 23:54:05 +0200
committerwm4 <wm4@nowhere>2014-06-09 01:20:53 +0200
commit3e2f16a89e625d9798217f39cc5be6211059acf9 (patch)
treeab74ca3b6974058904414bc4ea71cda212de88de /DOCS/man
parentda89af10768f75ceec9b9c0256649da6f4d843a2 (diff)
downloadmpv-3e2f16a89e625d9798217f39cc5be6211059acf9.tar.bz2
mpv-3e2f16a89e625d9798217f39cc5be6211059acf9.tar.xz
audio: add a "weak" gapless mode, and make it default
Basically, this allows gapless playback with similar files (including the ordered chapter case), while still being robust in general. The implementation is quite simplistic on purpose, in order to avoid all the weird corner cases that can occur when creating the filter chain. The consequence is that it might do not-gapless playback in more cases when needed, but if that bothers you, you still can use the normal gapless mode. Just using "--gapless-audio" or "--gapless-audio=yes" selects the old mode.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/en/options.rst43
1 files changed, 27 insertions, 16 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index e64c726a45..ec5061c4de 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -901,26 +901,37 @@ OPTIONS
Adjust the gamma of the video signal (default: 0). Not supported by all
video output drivers.
-``--gapless-audio``
+``--gapless-audio=<no|yes|weak``
Try to play consecutive audio files with no silence or disruption at the
- point of file change. This feature is implemented in a simple manner and
- relies on audio output device buffering to continue playback while moving
- from one file to another. If playback of the new file starts slowly, for
- example because it is played from a remote network location or because you
- have specified cache settings that require time for the initial cache
- fill, then the buffered audio may run out before playback of the new file
- can start.
+ point of file change. Default: ``weak``.
+
+ :no: Disable gapless audio.
+ :yes: The audio device is opened using parameters chosen according to the
+ first file played and is then kept open for gapless playback. This
+ means that if the first file for example has a low sample rate, then
+ the following files may get resampled to the same low sample rate,
+ resulting in reduced sound quality. If you play files with different
+ parameters, consider using options such as ``--audio-samplerate``
+ and ``--audio-format`` to explicitly select what the shared output
+ format will be.
+ :weak: Normally, the audio device is kept open (using the format it was
+ first initialized with). If the audio format the decoder output
+ changes, the audio device is closed and reopened. This means that
+ you will normally get gapless audio with files that were encoded
+ using the same settings, but might not be gapless in other cases.
+ (Unlike with ``yes``, you don't have to worry about corner cases
+ like the first file setting a very low quality output format, and
+ ruining the playback of higher quality files that follow.)
.. note::
- The audio device is opened using parameters chosen according to the
- first file played and is then kept open for gapless playback. This means
- that if the first file for example has a low sample rate, then the
- following files may get resampled to the same low sample rate, resulting
- in reduced sound quality. If you play files with different parameters,
- consider using options such as ``--audio-samplerate`` and
- ``--audio-format`` to explicitly select what the shared output format
- will be.
+ This feature is implemented in a simple manner and relies on audio
+ output device buffering to continue playback while moving from one file
+ to another. If playback of the new file starts slowly, for example
+ because it is played from a remote network location or because you have
+ specified cache settings that require time for the initial cache fill,
+ then the buffered audio may run out before playback of the new file
+ can start.
``--geometry=<[W[xH]][+-x+-y]>``, ``--geometry=<x:y>``
Adjust the initial window position or size. ``W`` and ``H`` set the window