diff options
author | wm4 <wm4@nowhere> | 2015-07-22 23:38:45 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2015-07-22 23:55:10 +0200 |
commit | 55879a8c0fad68fbe889057c16fc8f15bf3efce2 (patch) | |
tree | 86cce8a35904a0633393d1798df79f955a2efbdb /DOCS | |
parent | 63d112746dcf6b3c62b16cfd50eee91128054ce2 (diff) | |
download | mpv-55879a8c0fad68fbe889057c16fc8f15bf3efce2.tar.bz2 mpv-55879a8c0fad68fbe889057c16fc8f15bf3efce2.tar.xz |
cache: make backbuffer size configurable
Allow setting an arbitrary amount, instead of the fixed 50%.
This is nto striclty backwards compatible. The defaults don't change,
but the --cache/--cache-default options now set the readahead portion.
So in practice, users who configured this until now will see the
double amount of cache being used, _plus_ the 75MB default backbuffer
will be in use.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/interface-changes.rst | 3 | ||||
-rw-r--r-- | DOCS/man/options.rst | 16 |
2 files changed, 14 insertions, 5 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index cfd248b1e4..cad78108fb 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -20,6 +20,9 @@ Interface changes :: --- mpv 0.10.0 will be released --- + - add --cache-backbuffer; change --cache-default default to 75MB + the new total cache size is the sum of backbuffer and the cache size + specified by --cache-default or --cache - add ``track-list/N/audio-channels`` property - change --screenshot-tag-colorspace default value - add --stretch-image-subs-to-screen diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index e6beb07a36..934eda40cf 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -3064,13 +3064,13 @@ Cache seeking, such as MP4. Note that half the cache size will be used to allow fast seeking back. This - is also the reason why a full cache is usually reported as 50% full. The - cache fill display does not include the part of the cache reserved for - seeking back. Likewise, when starting a file the cache will be at 100%, - because no space is reserved for seeking back yet. + is also the reason why a full cache is usually not reported as 100% full. + The cache fill display does not include the part of the cache reserved for + seeking back. The actual maximum percentage will usually be the ratio + between readahead and backbuffer sizes. ``--cache-default=<kBytes|no>`` - Set the size of the cache in kilobytes (default: 150000 KB). Using ``no`` + Set the size of the cache in kilobytes (default: 75000 KB). Using ``no`` will not automatically enable the cache e.g. when playing from a network stream. Note that using ``--cache`` will always override this option. @@ -3090,6 +3090,12 @@ Cache on the situation, either of these might be slower than the other method. This option allows control over this. +``--cache-backbuffer=<kBytes>`` + Size of the cache back buffer (default: 75 KB). This will add to the total + cache size, and reserved the amount for seeking back. The reserved amount + will not be used for readahead, and instead preserves already read data to + enable fast seeking back. + ``--cache-file=<TMP|path>`` Create a cache file on the filesystem. |