X-Git-Url: https://git.kernelconcepts.de/?p=karo-tx-linux.git;a=blobdiff_plain;f=Documentation%2FDocBook%2Fmedia%2Fv4l%2Fpixfmt.xml;h=d871245d29735a0084ea422539a0dc23f106ca10;hp=965ea916784a1316800d2714030a9bf2c15701e2;hb=196bc62c37d6ce41dd5ba5875fec0f213537e674;hpb=45c680b9949ecdb829a331100ae49926bf82899c
diff --git a/Documentation/DocBook/media/v4l/pixfmt.xml b/Documentation/DocBook/media/v4l/pixfmt.xml
index 965ea916784a..d871245d2973 100644
--- a/Documentation/DocBook/media/v4l/pixfmt.xml
+++ b/Documentation/DocBook/media/v4l/pixfmt.xml
@@ -539,6 +539,10 @@ colorspaces except for BT.2020 which uses limited range R'G'B' quantization.V4L2_COLORSPACE_BT2020
See .
+
+ V4L2_COLORSPACE_DCI_P3
+ See .
+
V4L2_COLORSPACE_SMPTE240M
See .
@@ -601,6 +605,14 @@ colorspaces except for BT.2020 which uses limited range R'G'B' quantization.V4L2_XFER_FUNC_NONE
Do not use a transfer function (i.e. use linear RGB values).
+
+ V4L2_XFER_FUNC_DCI_P3
+ Use the DCI-P3 transfer function.
+
+
+ V4L2_XFER_FUNC_SMPTE2084
+ Use the SMPTE 2084 transfer function.
+
@@ -1154,6 +1166,68 @@ clamped to the range [-0.5…0.5]. The Y'CbCr quantization is limited range
clamped to the range [-0.5…0.5]. The Yc'CbcCrc quantization is limited range.
+
+ Colorspace DCI-P3 (<constant>V4L2_COLORSPACE_DCI_P3</constant>)
+ The standard defines the colorspace used by cinema
+projectors that use the DCI-P3 colorspace.
+The default transfer function is V4L2_XFER_FUNC_DCI_P3.
+The default Y'CbCr encoding is V4L2_YCBCR_ENC_709. Note that this
+colorspace does not specify a Y'CbCr encoding since it is not meant to be encoded
+to Y'CbCr. So this default Y'CbCr encoding was picked because it is the HDTV
+encoding. The default Y'CbCr quantization is limited range. The chromaticities of
+the primary colors and the white reference are:
+
+ DCI-P3 Chromaticities
+
+ &cs-str;
+
+
+ Color
+ x
+ y
+
+
+
+
+ Red
+ 0.6800
+ 0.3200
+
+
+ Green
+ 0.2650
+ 0.6900
+
+
+ Blue
+ 0.1500
+ 0.0600
+
+
+ White Reference
+ 0.3140
+ 0.3510
+
+
+
+
+
+
+ Transfer function:
+
+ L' = L1/2.6
+
+
+
+ Inverse Transfer function:
+
+ L = L'2.6
+
+
+
+ Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709.
+
+
Colorspace SMPTE 240M (<constant>V4L2_COLORSPACE_SMPTE240M</constant>)
The standard was an interim standard used during
@@ -1402,6 +1476,41 @@ and V4L2_QUANTIZATION_FULL_RANGE.
+
+ Detailed Transfer Function Descriptions
+
+ Transfer Function SMPTE 2084 (<constant>V4L2_XFER_FUNC_SMPTE2084</constant>)
+ The standard defines the transfer function used by
+High Dynamic Range content.
+
+
+ Constants:
+
+ m1 = (2610 / 4096) / 4
+ m2 = (2523 / 4096) * 128
+ c1 = 3424 / 4096
+ c2 = (2413 / 4096) * 32
+ c3 = (2392 / 4096) * 32
+
+
+
+ Transfer function:
+
+ L' = ((c1 + c2 * Lm1) / (1 + c3 * Lm1))m2
+
+
+
+
+
+ Inverse Transfer function:
+
+ L = (max(L'1/m2 - c1, 0) / (c2 - c3 * L'1/m2))1/m1
+
+
+
+
+
+
Indexed Format
@@ -1623,7 +1732,7 @@ extended control V4L2_CID_MPEG_STREAM_TYPE, see