summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-07-22 23:38:45 +0200
committerwm4 <wm4@nowhere>2015-07-22 23:55:10 +0200
commit55879a8c0fad68fbe889057c16fc8f15bf3efce2 (patch)
tree86cce8a35904a0633393d1798df79f955a2efbdb /DOCS
parent63d112746dcf6b3c62b16cfd50eee91128054ce2 (diff)
downloadmpv-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.rst3
-rw-r--r--DOCS/man/options.rst16
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.