diff options
author | Niklas Haas <git@haasn.dev> | 2022-01-03 03:56:36 +0100 |
---|---|---|
committer | Niklas Haas <github-daiK1o@haasn.dev> | 2022-01-07 06:28:14 +0100 |
commit | a9cb2e2821adb40e7548e8233390e79706104041 (patch) | |
tree | 382cee5ce44b9c6cf3ae196e23e908c4718ebbea /DOCS | |
parent | 57bc5ba6d6579d5f1e6897f6915a3a940b84bb73 (diff) | |
download | mpv-a9cb2e2821adb40e7548e8233390e79706104041.tar.bz2 mpv-a9cb2e2821adb40e7548e8233390e79706104041.tar.xz |
vo_gpu_next: update for new tone mapping options
This was significantly refactored upstream. Switch to new APIs and add
new tone mapping curves and options.
cf. https://code.videolan.org/videolan/libplacebo/-/merge_requests/212
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/interface-changes.rst | 3 | ||||
-rw-r--r-- | DOCS/man/options.rst | 28 |
2 files changed, 26 insertions, 5 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index e8ad97cd55..2c59f0f6b5 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -32,6 +32,9 @@ Interface changes `--interpolation-preserve` `--lut`, `--lut-type`, `--image-lut`, `--image-lut-type` and `--target-lut` along with it. - add `--target-colorspace-hint` + - add `--tone-mapping-crosstalk` + - add `--tone-mapping` options `auto`, `spline` and `bt.2446a` + - add `--inverse-tone-mapping` --- mpv 0.34.0 --- - deprecate selecting by card number with `--drm-connector`, add `--drm-device` which can be used instead diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 000e9185e5..6742ec1a6c 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -6302,6 +6302,8 @@ them. reduction (e.g. playing back BT.2020 content on a standard gamut display). Valid values are: + auto + Choose the best curve according to internal heuristics. (Default) clip Hard-clip any out-of-range values. Use this when you care about perfect color accuracy for in-range values at the cost of completely @@ -6327,13 +6329,17 @@ them. you should also enable ``--hdr-compute-peak`` for the best results. bt.2390 Perceptual tone mapping curve (EETF) specified in ITU-R Report BT.2390. - This is the recommended curve to use for typical HDR-mastered content. - (Default) gamma Fits a logarithmic transfer between the tone curves. linear Linearly stretches the entire reference gamut to (a linear multiple of) the display. + spline + Perceptually linear single-pivot polynomial. (``--vo=gpu-next`` only) + bt.2446a + HDR<->SDR mapping specified in ITU-R Report BT.2446, method A. This is + the recommended curve for well-mastered content. (``--vo=gpu-next`` + only) ``--tone-mapping-param=<value>`` Set tone mapping parameters. By default, this is set to the special string @@ -6358,6 +6364,17 @@ them. Specifies the exponent of the function. Defaults to 1.8. linear Specifies the scale factor to use while stretching. Defaults to 1.0. + spline + Specifies the knee point (in PQ space). Defaults to 0.30. + +``--inverse-tone-mapping`` + If set, allows inverse tone mapping (expanding SDR to HDR). Not supported + by all tone mapping curves. Use with caution. (``--vo=gpu-next`` only) + +``--tone-mapping-crosstalk=<0.0..0.30>`` + If nonzero, apply an extra crosstalk matrix before tone mapping. Can help + improve the appearance of strongly saturated monochromatic highlights. + (Default: 0.04, only affects ``--vo=gpu-next``) ``--tone-mapping-max-boost=<1.0..10.0>`` Upper limit for how much the tone mapping algorithm is allowed to boost @@ -6365,7 +6382,8 @@ them. allows no additional brightness boost. A value of 2.0 would allow over-exposing by a factor of 2, and so on. Raising this setting can help reveal details that would otherwise be hidden in dark scenes, but raising - it too high will make dark scenes appear unnaturally bright. + it too high will make dark scenes appear unnaturally bright. (``-vo=gpu`` + only) ``--hdr-compute-peak=<auto|yes|no>`` Compute the HDR peak and frame average brightness per-frame instead of @@ -6413,8 +6431,8 @@ them. Apply desaturation for highlights (default: 0.75). The parameter controls the strength of the desaturation curve. A value of 0.0 completely disables it, while a value of 1.0 means that overly bright colors will tend towards - white. (This is not always the case, especially not for highlights that are - near primary colors) + white. This is not always the case, especially not for highlights that are + near primary colors. (``--vo=gpu`` only) Values in between apply progressively more/less aggressive desaturation. This setting helps prevent unnaturally oversaturated colors for |