summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorNiklas Haas <git@haasn.xyz>2017-08-03 12:46:57 +0200
committerNiklas Haas <git@haasn.xyz>2017-08-03 12:46:57 +0200
commit5e1e7d32e83861981b777faeb9f764c163b46c68 (patch)
treecca785ad92efda33d7de4e01a9242173e055edd8 /DOCS/man
parent6074cfdfd4b461c7991c9d16e57a6d1b63751c72 (diff)
downloadmpv-5e1e7d32e83861981b777faeb9f764c163b46c68.tar.bz2
mpv-5e1e7d32e83861981b777faeb9f764c163b46c68.tar.xz
vo_opengl: generalize HDR tone mapping to gamut mapping
Since this code was already written for HDR, and is now per-channel (because it works better for HDR as well), we can actually reuse this to get very high quality gamut mapping without clipping. The only required change is to move the tone mapping from before the gamut map to after the gamut map. Additonally, we need to also account for changes in the signal range as a result of applying the CMS when we compute ref_peak, which is fortunately pretty easy because we only need to consider the case of primaries mapping to themselves. Since `HDR` no longer really makes sense as a label, rename it to `--tone-mapping` in general. Also fits better with `--tone-mapping-desat` etc. Arguably we could also rename `--hdr-compute-peak`, but that option is basically only useful for HDR content anyway because we don't need information about the signal range for gamut mapping. This (finally!) gives us reasonably high quality gamut mapping even in the absence of an ICC profile / 3DLUT.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/options.rst16
1 files changed, 9 insertions, 7 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index e824e04e0f..814f6fe2d9 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -4765,9 +4765,11 @@ The following video options are currently all specific to ``--vo=opengl`` and
The user should independently guarantee this before using these signal
formats for display.
-``--hdr-tone-mapping=<value>``
- Specifies the algorithm used for tone-mapping HDR images onto the target
- display. Valid values are:
+``--tone-mapping=<value>``
+ Specifies the algorithm used for tone-mapping images onto the target
+ display. This is relevant for both HDR->SDR conversion as well as gamut
+ reduction (e.g. playing back BT.2020 content on a standard gamut display).
+ Valid values are:
clip
Hard-clip any out-of-range values. Use this when you care about
@@ -4786,10 +4788,10 @@ The following video options are currently all specific to ``--vo=opengl`` and
results in flattening of details and degradation in color accuracy.
hable
Similar to ``reinhard`` but preserves both dark and bright details
- better (slightly sigmoidal), at the cost of slightly darkening
- everything. Developed by John Hable for use in video games. Use this
- when you care about detail preservation more than color/brightness
- accuracy. This is roughly equivalent to
+ better (slightly sigmoidal), at the cost of slightly darkening /
+ desaturating everything. Developed by John Hable for use in video
+ games. Use this when you care about detail preservation more than
+ color/brightness accuracy. This is roughly equivalent to
``--hdr-tone-mapping=reinhard --tone-mapping-param=0.24``.
gamma
Fits a logarithmic transfer between the tone curves.