[x265] [PATCH] docs: clarify units of HDR SEI commands

[Steve Borho]

# HG changeset patch
# User Steve Borho <steve at borho.org>
# 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.