diff options
| author | Niklas Haas <git@nand.wakku.to> | 2016-05-30 19:56:58 +0200 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2016-05-30 20:17:33 +0200 |
| commit | 45c3e0f0d0c836158ab38db53156bb6461ad7437 (patch) | |
| tree | fa74784173edcbc2771b045947e0d64ed1b44bd9 /DOCS/man | |
| parent | 098ff4174c6c9cc59e65c6f09b23b3adaee03983 (diff) | |
| download | mpv-45c3e0f0d0c836158ab38db53156bb6461ad7437.tar.bz2 mpv-45c3e0f0d0c836158ab38db53156bb6461ad7437.tar.xz | |
vo_opengl: refactor HDR mechanism
Instead of doing HDR tone mapping on an ad-hoc basis inside
pass_colormanage, the reference peak of an image is now part of the
image params (alongside colorspace, gamma, etc.) and tone mapping is
done whenever peak_src != peak_dst.
To get sensible behavior when mixing HDR and SDR content and displays,
target-brightness is a generic filler for "the assumed brightness of SDR
content".
This gets rid of the weird display_scaled hack, sets the framework
for multiple HDR functions with difference reference peaks, and allows
us to (in a future commit) autodetect the right source peak from
the HDR metadata.
(Apart from metadata, the source peak can also be controlled via
vf_format. For HDR content this adjusts the overall image brightness,
for SDR content it's like simulating a different exposure)
Diffstat (limited to 'DOCS/man')
| -rw-r--r-- | DOCS/man/vf.rst | 8 | ||||
| -rw-r--r-- | DOCS/man/vo.rst | 7 |
2 files changed, 12 insertions, 3 deletions
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst index 40c499cb5a..b4e4438f78 100644 --- a/DOCS/man/vf.rst +++ b/DOCS/man/vf.rst @@ -312,6 +312,14 @@ Available filters are: :prophoto: ProPhoto RGB (ROMM) curve :st2084: SMPTE ST2084 (HDR) curve + ``<peak>`` + Reference peak illumination for the video file. This is mostly + interesting for HDR, but it can also be used tone map SDR content + to a darker or brighter exposure. + + The default of 0.0 will default to the display's reference brightness + for SDR and the source's reference brightness for HDR. + ``<stereo-in>`` Set the stereo mode the video is assumed to be encoded in. Takes the same values as the ``--video-stereo-mode`` option. diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst index 717c4738a9..3b16e74ae8 100644 --- a/DOCS/man/vo.rst +++ b/DOCS/man/vo.rst @@ -1061,9 +1061,10 @@ Available video output drivers are: ``target-brightness=<1..100000>`` Specifies the display's approximate brightness in cd/m^2. When playing - HDR content, video colors will be tone mapped to this target brightness - using the algorithm specified by ``hdr-tone-mapping``. The default of - 250 cd/m^2 corresponds to a typical consumer display. + HDR content on a SDR display (or SDR content on an HDR display), video + colors will be tone mapped to this target brightness using the + algorithm specified by ``hdr-tone-mapping``. The default of 250 cd/m^2 + corresponds to a typical consumer display. ``hdr-tone-mapping=<value>`` Specifies the algorithm used for tone-mapping HDR images onto the |