summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorNiklas Haas <git@haasn.xyz>2017-09-10 18:18:31 +0200
committerNiklas Haas <git@haasn.xyz>2017-09-10 18:19:46 +0200
commitd0c87dd57918cab1afc4d5968355b6253377c0b1 (patch)
treebe74d142ba356485b0f9e58bddff37495229dab4 /DOCS/man/options.rst
parentb19b0869d68121f4e9a973b53d9abbd370d0a160 (diff)
downloadmpv-d0c87dd57918cab1afc4d5968355b6253377c0b1.tar.bz2
mpv-d0c87dd57918cab1afc4d5968355b6253377c0b1.tar.xz
vo_opengl: add a gamut warning feature
This clearly highlights all out-of-gamut/clipped pixels. (Either too bright or too saturated) Has some (documented) caveats. Also make TONE_MAPPING_CLIP stop actually clamping the value range (it's unnecessary and breaks this feature).
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index dd9a51e807..ce14d3e92a 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -4865,6 +4865,18 @@ The following video options are currently all specific to ``--vo=opengl`` and
The default of 2.0 is somewhat conservative and will mostly just apply to
skies or directly sunlit surfaces. A setting of 0.0 disables this option.
+``--gamut-warning``
+ If enabled, mpv will mark all clipped/out-of-gamut pixels that exceed a
+ given threshold (currently hard-coded to 101%). The affected pixels will be
+ inverted to make them stand out. Note: This option applies after the
+ effects of all of mpv's color space transformation / tone mapping options,
+ so it's a good idea to combine this with ``--tone-mapping=clip`` and use
+ ``--target-gamut`` to set the gamut to simulate. For example,
+ ``--target-gamut=bt.709`` would make mpv highlight all pixels that exceed the
+ gamut of a standard gamut (sRGB) display. This option also does not work
+ well with ICC profiles, since the 3DLUTs are always generated against the
+ source color space and have chromatically-accurate clipping built in.
+
``--use-embedded-icc-profile``
Load the embedded ICC profile contained in media files such as PNG images.
(Default: yes). Note that this option only works when also using a display