diff options
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/interface-changes.rst | 2 | ||||
| -rw-r--r-- | DOCS/man/options.rst | 41 | ||||
| -rw-r--r-- | DOCS/man/vo.rst | 12 |
3 files changed, 52 insertions, 3 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index a8eca8d629..c2543b4e1d 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -27,6 +27,8 @@ Interface changes --- mpv 0.31.0 --- - add `--d3d11-output-csp` to enable explicit selection of a D3D11 swap chain color space. + - add an builtin "sw-fast" profile, which restores performance settings + that were switched to higher quality since mpv 0.30.0 --- mpv 0.30.0 --- - add `--d3d11-output-format` to enable explicit selection of a D3D11 swap chain format. diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index c8af27bcb7..76f39dc29f 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -3833,6 +3833,21 @@ Software Scaler ``--sws-cvs=<v>`` Software scaler chroma vertical shifting. See ``--sws-scaler``. +``--sws-bitexact=<yes|no>`` + Unknown functionality (default: no). Consult libswscale source code. The + primary purpose of this, as far as libswscale API goes), is to produce + exactly the same output for the same input on all platforms (output has the + same "bits" everywhere, thus "bitexact"). Typically disables optimizations. + +``--sws-fast=<yes|no>`` + Allow optimizations that help with performance, but reduce quality (default: + no). + + VOs like ``drm`` and ``x11`` will benefit a lot from using ``--sws-fast``. + You may need to set other options, like ``--sws-scaler``. The builtin + ``sws-fast`` profile sets this option and some others to gain performance + for reduced quality. + ``--sws-allow-zimg=<yes|no>`` Allow using zimg (if the component using the internal swscale wrapper explicitly allows so). In this case, zimg *may* be used, if the internal @@ -3846,14 +3861,34 @@ Software Scaler correctly, a verbose priority log message will indicate whether zimg is being used. - Currently, barely anything uses this. + Most things which need software conversion can make use of this. -``--zimg--scaler=<point|bilinear|bicubic|spline16|lanczos>`` +``--zimg--scaler=<point|bilinear|bicubic|spline16|spline36|lanczos>`` Zimg luma scaler to use (default: bilinear). +``--zimg-scaler-param-a=<default|float>``, ``--zimg-scaler-param-b=<default|float>`` + Set scaler parameters. By default, these are set to the special string + ``default``, which maps to a scaler-specific default value. Ignored if the + scaler is not tunable. + + ``lanczos`` + ``--zimg-scaler-param-a`` is the number of taps. + + ``bicubic`` + a and b are the bicubic b and c parameters. + +``--zimg-scaler-chroma=...`` + Same as ``--zimg--scaler``, for for chroma interpolation. + +``--zimg-scaler-chroma-param-a``, ``--zimg-scaler-chroma-param-b`` + Same as ``--zimg-scaler-param-a`` / ``--zimg-scaler-param-b``, for chroma. + +``--zimg-dither=<no|ordered|random|error-diffusion>`` + Dithering (default: random). + ``--zimg-fast=<yes|no>`` Allow optimizations that help with performance, but reduce quality (default: - yes). Currently, this may simplify gamma conversion operations. + no). Currently, this may simplify gamma conversion operations. Audio Resampler diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst index ea2d3ee645..50db983f06 100644 --- a/DOCS/man/vo.rst +++ b/DOCS/man/vo.rst @@ -71,6 +71,9 @@ Available video output drivers are: Shared memory video output driver without hardware acceleration that works whenever X11 is present. + Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent + performance. + .. note:: This is a fallback only, and should not be normally used. ``vdpau`` (X11 only) @@ -383,6 +386,9 @@ Available video output drivers are: Depends on support of true color by modern terminals to display the images at full color range. On Windows it requires an ansi terminal such as mintty. + Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent + performance. + ``--vo-tct-algo=<algo>`` Select how to write the pixels to the terminal. @@ -482,6 +488,9 @@ Available video output drivers are: environment (e.g. no X). Does not support hardware acceleration (if you need this, check the ``drm`` backend for ``gpu`` VO). + Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent + performance. + The following global options are supported by this video output: ``--drm-connector=[<gpu_number>.]<name>`` @@ -583,4 +592,7 @@ Available video output drivers are: Shared memory video output driver without hardware acceleration that works whenever Wayland is present. + Since mpv 0.30.0, you may need to use ``--profile=sw-fast`` to get decent + performance. + .. note:: This is a fallback only, and should not be normally used. |