summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorNiklas Haas <git@nand.wakku.to>2016-05-15 20:16:12 +0200
committerNiklas Haas <git@nand.wakku.to>2016-05-16 02:45:39 +0200
commitf81f486c68ca55c1e6175e41b0473d9568a6fe5b (patch)
tree647dcc25bdcc21e6b47ced6509470f827357e0c0 /DOCS/man
parent965031ccd5acb04dcff2bbbfea0ac35a3c035ecb (diff)
downloadmpv-f81f486c68ca55c1e6175e41b0473d9568a6fe5b.tar.bz2
mpv-f81f486c68ca55c1e6175e41b0473d9568a6fe5b.tar.xz
vo_opengl: implement HDR (SMPTE ST2084)
Currently, this relies on the user manually entering their display brightness (since we have no way to detect this at runtime or from ICC metadata). The default value of 250 was picked by looking at ~10 reviews on tftcentral.co.uk and realizing they all come with around 250 cd/m^2 out of the box. (In addition, ITU-R Rec. BT.2022 supports this) Since there is no metadata in FFmpeg to indicate usage of this TRC, the only way to actually play HDR content currently is to set ``--vf=format=gamma=st2084``. (It could be guessed based on SEI, but this is not implemented yet) Incidentally, since SEI is ignored, it's currently assumed that all content is scaled to 10,000 cd/m^2 (and hard-clipped where out of range). I don't see this assumption changing much, though. As an unfortunate consequence of the fact that we don't know the display brightness, mixed with the fact that LittleCMS' parametric tone curves are not flexible enough to support PQ, we have to build the 3DLUT against gamma 2.2 if it's used. This might be a good thing, though, consdering the PQ source space is probably not fantastic for interpolation either way. Partially addresses #2572.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/vf.rst1
-rw-r--r--DOCS/man/vo.rst8
2 files changed, 9 insertions, 0 deletions
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index 46384eb20f..e742bc4ada 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -310,6 +310,7 @@ Available filters are:
:gamma2.2: Pure power curve (gamma 2.2)
:gamma2.8: Pure power curve (gamma 2.8)
:prophoto: ProPhoto RGB (ROMM) curve
+ :st2084: SMPTE ST2084 (HDR) curve
``<stereo-in>``
Set the stereo mode the video is assumed to be encoded in. Takes the
diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst
index 7892761581..046fa7e0e6 100644
--- a/DOCS/man/vo.rst
+++ b/DOCS/man/vo.rst
@@ -1052,6 +1052,14 @@ Available video output drivers are:
Pure power curve (gamma 2.8), also used for BT.470-BG
prophoto
ProPhoto RGB (ROMM)
+ st2084
+ SMPTE ST2084 (HDR) curve, PQ OETF
+
+ ``target-brightness=<1..100000>``
+ Specifies the display's approximate brightness in cd/m^2. When playing
+ HDR content, video colors will be scaled and clipped to this
+ brightness. The default of 250 cd/m^2 corresponds to a typical consumer
+ display.
``icc-profile=<file>``
Load an ICC profile and use it to transform video RGB to screen output.