diff options
author | Niklas Haas <git@haasn.dev> | 2023-06-19 12:59:51 +0200 |
---|---|---|
committer | Niklas Haas <github-daiK1o@haasn.dev> | 2023-06-21 23:52:35 +0200 |
commit | f1600ea9cf1664a094983cf75d63dc6ea09fe1b6 (patch) | |
tree | c8e61650654fd592894545b981cc9acb5e2b68d8 /DOCS | |
parent | 594458838ecf2229797e10266915e0f33c95d4fd (diff) | |
download | mpv-f1600ea9cf1664a094983cf75d63dc6ea09fe1b6.tar.bz2 mpv-f1600ea9cf1664a094983cf75d63dc6ea09fe1b6.tar.xz |
vo_gpu_next: add missing --gamut-mapping-mode options
Adds the missing upstream values that were exposed by the new gamut
mapping API.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/interface-changes.rst | 1 | ||||
-rw-r--r-- | DOCS/man/options.rst | 34 |
2 files changed, 28 insertions, 7 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index 23bcb229fd..eb1de6a17c 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -76,6 +76,7 @@ Interface changes save cache files for these features; explictly setting `--icc-cache-dir` and `--gpu-shader-cache` is no longer required - remove the `--tone-mapping-crosstalk` option + - add `--gamut-mapping-mode=perceptual|relative|saturation|absolute|linear` --- mpv 0.35.0 --- - add the `--vo=gpu-next` video output driver, as well as the options `--allow-delayed-peak-detect`, `--builtin-scalers`, diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index cbdd3ede1b..ed85c44eca 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -6565,16 +6565,36 @@ them. auto Choose the best mode automatically. (Default) clip - Hard-clip to the gamut (per-channel). - warn - Simply highlight out-of-gamut pixels. + Hard-clip to the gamut (per-channel). Very low quality, but free. + perceptual + Performs a perceptually balanced gamut mapping using a soft knee + function to roll-off clipped regions, and a hue shifting function to + preserve saturation. (``--vo=gpu-next`` only) + relative + Performs relative colorimetric clipping, while maintaining an + exponential relationship between brightness and chromaticity. + (``--vo=gpu-next`` only) + saturation + Performs simple RGB->RGB saturation mapping. The input R/G/B channels + are mapped directly onto the output R/G/B channels. Will never clip, + but will distort all hues and/or result in a faded look. + (``--vo=gpu-next`` only) + absolute + Performs absolute colorimetric clipping. Like ``relative``, but does + not adapt the white point. (``--vo=gpu-next`` only) desaturate - Chromatically desaturate out-of-gamut colors towards white. + Performs constant-luminance colorimetric clipping, desaturing colors + towards white until they're in-range. darken - Linearly darken the entire image, then clip to the color volume. Unlike - ``clip``, this does not destroy detail in saturated regions, but comes - at the cost of sometimes significantly lowering output brightness. + Uniformly darkens the input slightly to prevent clipping on blown-out + highlights, then clamps colorimetrically to the input gamut boundary, + biased slightly to preserve chromaticity over luminance. (``--vo=gpu-next`` only) + warn + Performs no gamut mapping, but simply highlights out-of-gamut pixels. + linear + Linearly/uniformly desaturates the image in order to bring the entire + image into the target gamut. (``--vo=gpu-next`` only) ``--hdr-compute-peak=<auto|yes|no>`` Compute the HDR peak and frame average brightness per-frame instead of |