path: root/DOCS
diff options
authorwm4 <wm4@nowhere>2012-12-02 00:22:54 +0100
committerwm4 <wm4@nowhere>2012-12-03 21:08:52 +0100
commit3486f59fe28efa81ce6951208b94cec91ad6cdb8 (patch)
treee85c775c112ce3465ccf6f367f08821828626313 /DOCS
parentc02f2529385ab2ddd9605c5ebe5d2a68be200ec4 (diff)
core: automatically pause on low cache
When the cache fill status goes below a certain threshold, automatically pause the player. When the cache is filled again, unpause again. This is intended to help with streaming from http. It's better to pause a while, rather than exposing extremely crappy behavior when packet reads during decoding block the entire player. In theory, we should try to increase the cache if underruns happen too often. Unfortunately, changing the cache implementation would be very hard, because it's insane code (forks, uses shared memory and "volatile" etc.). So for now, this just reduces the frequency of the stuttering if the network is absolutely too slow to play the stream in realtime.
Diffstat (limited to 'DOCS')
1 files changed, 10 insertions, 1 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index b5a2b02537..a7aa700786 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -261,9 +261,18 @@
from slow media, but can also have negative effects, especially with file
formats that require a lot of seeking, such as mp4. See also ``--no-cache``.
+ If the cache percentage goes below the specified value, pause and wait
+ until the percentage set by ``--cache-min`` is reached, then resume
+ playback (default: 10). If ``no`` is specified, this behavior is disabled.
+ When the player is paused this way, the status line shows ``Buffering``
+ instead of ``Paused``, and the OSD uses a clock symbol instead of the
+ normal paused symbol.
Playback will start when the cache has been filled up to <percentage> of
- the total.
+ the total (default: 20).
If a seek is to be made to a position within <percentage> of the cache