# HG changeset patch
# User Steve Borho <[email protected]>
# Date 1452869743 21600
# Fri Jan 15 08:55:43 2016 -0600
# Branch stable
# Node ID 0d27cf647b056c3b29d685887a9ae88dca2a6281
# Parent cadfa44f3913bb842a7f531485d68121b8a16422
docs: clarify units of HDR SEI commands
diff -r cadfa44f3913 -r 0d27cf647b05 doc/reST/cli.rst
--- a/doc/reST/cli.rst Tue Jan 12 10:24:33 2016 -0600
+++ b/doc/reST/cli.rst Fri Jan 15 08:55:43 2016 -0600
@@ -1660,10 +1660,13 @@
a string which is parsed when the stream header SEI are emitted. The
string format is "G(%hu,%hu)B(%hu,%hu)R(%hu,%hu)WP(%hu,%hu)L(%u,%u)"
where %hu are unsigned 16bit integers and %u are unsigned 32bit
- integers. The SEI includes X,Y display primaries for RGB channels,
- white point X,Y and max,min luminance values. (HDR)
+ integers. The SEI includes X,Y display primaries for RGB channels
+ and white point (WP) in units of 0.00002 and max,min luminance (L)
+ values in units of 0.0001 candela per meter square. (HDR)
- Example for D65P3 1000-nits:
+ Example for a P3D65 1000-nits monitor, where G(x=0.264, y=0.690),
+ B(x=0.150, y=0.060), R(x=0.680, y=0.320), WP(x=0.3127, y=0.3290),
+ L(max=1000, min=0.0001):
G(13250,34500)B(7500,3000)R(34000,16000)WP(15635,16450)L(10000000,1)
@@ -1672,8 +1675,9 @@
.. option:: --max-cll <string>
- Maximum content light level and maximum frame average light level as
- required by the Consumer Electronics Association 861.3 specification.
+ Maximum content light level (MaxCLL) and maximum frame average light
+ level (MaxFALL) as required by the Consumer Electronics Association
+ 861.3 specification.
Specified as a string which is parsed when the stream header SEI are
emitted. The string format is "%hu,%hu" where %hu are unsigned 16bit
@@ -1681,6 +1685,11 @@
maximum is indicated), the second value is the maximum picture
average light level (or 0). (HDR)
+ Example for MaxCLL=1000 candela per square meter, MaxFALL=400
+ candela per square meter:
+
+ --max-cll “1000,400”
+
Note that this string value will need to be escaped or quoted to
protect against shell expansion on many platforms. No default.
_______________________________________________
x265-devel mailing list
[email protected]
https://mailman.videolan.org/listinfo/x265-devel
