summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNiklas Haas <git@nand.wakku.to>2016-05-06 18:00:39 +0200
committerwm4 <wm4@nowhere>2016-05-06 18:09:17 +0200
commit7c5188c27eacf4e13238f3621e015518c87bce10 (patch)
treee07d9d9292235b51cf869d2c0433b23e6824b4bc
parenta93fb460cdea2951bae039b8e004b5042c337d05 (diff)
downloadmpv-7c5188c27eacf4e13238f3621e015518c87bce10.tar.bz2
mpv-7c5188c27eacf4e13238f3621e015518c87bce10.tar.xz
DOCS: update documentation related to color management
Some of this documentation was left woefully inaccurate as color management in mpv evolved. This commit updates all of the wording and adds notes and comments where appropriate.
-rw-r--r--DOCS/man/vf.rst2
-rw-r--r--DOCS/man/vo.rst16
2 files changed, 12 insertions, 6 deletions
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index faca4114a9..46384eb20f 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -303,7 +303,7 @@ Available filters are:
Available gamma functions are:
:auto: automatic selection (default)
- :bt.1886: ITU-R BT.1886 (approximation of BT.601/BT.709/BT.2020 curve)
+ :bt.1886: ITU-R BT.1886 (EOTF corresponding to BT.601/BT.709/BT.2020)
:srgb: IEC 61966-2-4 (sRGB)
:linear: Linear light
:gamma1.8: Pure power curve (gamma 1.8)
diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst
index 0e091591e2..647dd8c1a4 100644
--- a/DOCS/man/vo.rst
+++ b/DOCS/man/vo.rst
@@ -855,6 +855,10 @@ Available video output drivers are:
0.8
Pitch black room
+ NOTE: Typical movie content (Blu-ray etc.) already contains a gamma
+ drop of about 0.8, so specifying it here as well will result in even
+ even darker image than intended!
+
``gamma-auto``
Automatically corrects the gamma value depending on ambient lighting
conditions (adding a gamma boost for dark rooms).
@@ -865,8 +869,9 @@ Available video output drivers are:
NOTE: Only implemented on OS X.
``target-prim=<value>``
- Specifies the primaries of the display. Video colors will be adapted
- to this colorspace if necessary. Valid values are:
+ Specifies the primaries of the display. Video colors will be adapted to
+ this colorspace when ICC color management is not being used. Valid
+ values are:
auto
Disable any adaptation (default)
@@ -893,12 +898,13 @@ Available video output drivers are:
``target-trc=<value>``
Specifies the transfer characteristics (gamma) of the display. Video
- colors will be adjusted to this curve. Valid values are:
+ colors will be adjusted to this curve when ICC color management is
+ not being used. Valid values are:
auto
Disable any adaptation (default)
bt.1886
- ITU-R BT.1886 curve, without the brightness drop (approx. 1.961)
+ ITU-R BT.1886 curve (assuming infinite contrast)
srgb
IEC 61966-2-4 (sRGB)
linear
@@ -913,7 +919,7 @@ Available video output drivers are:
ProPhoto RGB (ROMM)
``icc-profile=<file>``
- Load an ICC profile and use it to transform linear RGB to screen output.
+ Load an ICC profile and use it to transform video RGB to screen output.
Needs LittleCMS 2 support compiled in. This option overrides the
``target-prim``, ``target-trc`` and ``icc-profile-auto`` options.