iv/linux
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[media] DocBook media: document the new DCI-P3 colorspace

Browse Source 
Document this colorspace.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
This commit is contained in:
Hans Verkuil 2015-09-13 13:41:30 -03:00 committed by Mauro Carvalho Chehab
parent 529a796030
commit 7146a9cfa4
2 changed files with 79 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Documentation/DocBook/media/v4l/biblio.xml
View File

@ -177,6 +177,15 @@ Signal - NTSC for Studio Applications"</title>
1125-Line High-Definition Production"</title> 1125-Line High-Definition Production"</title>
</biblioentry> </biblioentry>
<biblioentry id="smpte431">
<abbrev>SMPTE&nbsp;RP&nbsp;431-2</abbrev>
<authorgroup>
<corpauthor>Society of Motion Picture and Television Engineers
(<ulink url="http://www.smpte.org">http://www.smpte.org</ulink>)</corpauthor>
</authorgroup>
<title>SMPTE RP 431-2:2011 "D-Cinema Quality - Reference Projector and Environment"</title>
</biblioentry>
<biblioentry id="srgb"> <biblioentry id="srgb">
<abbrev>sRGB</abbrev> <abbrev>sRGB</abbrev>
<authorgroup> <authorgroup>

70
Documentation/DocBook/media/v4l/pixfmt.xml
View File

@ -539,6 +539,10 @@ colorspaces except for BT.2020 which uses limited range R'G'B' quantization.</pa
<entry><constant>V4L2_COLORSPACE_BT2020</constant></entry> <entry><constant>V4L2_COLORSPACE_BT2020</constant></entry>
<entry>See <xref linkend="col-bt2020" />.</entry> <entry>See <xref linkend="col-bt2020" />.</entry>
</row> </row>
<row>
<entry><constant>V4L2_COLORSPACE_DCI_P3</constant></entry>
<entry>See <xref linkend="col-dcip3" />.</entry>
</row>
<row> <row>
<entry><constant>V4L2_COLORSPACE_SMPTE240M</constant></entry> <entry><constant>V4L2_COLORSPACE_SMPTE240M</constant></entry>
<entry>See <xref linkend="col-smpte-240m" />.</entry> <entry>See <xref linkend="col-smpte-240m" />.</entry>
@ -601,6 +605,10 @@ colorspaces except for BT.2020 which uses limited range R'G'B' quantization.</pa
<entry><constant>V4L2_XFER_FUNC_NONE</constant></entry> <entry><constant>V4L2_XFER_FUNC_NONE</constant></entry>
<entry>Do not use a transfer function (i.e. use linear RGB values).</entry> <entry>Do not use a transfer function (i.e. use linear RGB values).</entry>
</row> </row>
<row>
<entry><constant>V4L2_XFER_FUNC_DCI_P3</constant></entry>
<entry>Use the DCI-P3 transfer function.</entry>
</row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
@ -1154,6 +1162,68 @@ clamped to the range [-0.5&hellip;0.5]. The Y'CbCr quantization is limited range
clamped to the range [-0.5&hellip;0.5]. The Yc'CbcCrc quantization is limited range.</para> clamped to the range [-0.5&hellip;0.5]. The Yc'CbcCrc quantization is limited range.</para>
</section> </section>
<section id="col-dcip3">
<title>Colorspace DCI-P3 (<constant>V4L2_COLORSPACE_DCI_P3</constant>)</title>
<para>The <xref linkend="smpte431" /> standard defines the colorspace used by cinema
projectors that use the DCI-P3 colorspace.
The default transfer function is <constant>V4L2_XFER_FUNC_DCI_P3</constant>.
The default Y'CbCr encoding is <constant>V4L2_YCBCR_ENC_709</constant>. 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:</para>
<table frame="none">
<title>DCI-P3 Chromaticities</title>
<tgroup cols="3" align="left">
&cs-str;
<thead>
<row>
<entry>Color</entry>
<entry>x</entry>
<entry>y</entry>
</row>
</thead>
<tbody valign="top">
<row>
<entry>Red</entry>
<entry>0.6800</entry>
<entry>0.3200</entry>
</row>
<row>
<entry>Green</entry>
<entry>0.2650</entry>
<entry>0.6900</entry>
</row>
<row>
<entry>Blue</entry>
<entry>0.1500</entry>
<entry>0.0600</entry>
</row>
<row>
<entry>White Reference</entry>
<entry>0.3140</entry>
<entry>0.3510</entry>
</row>
</tbody>
</tgroup>
</table>
<variablelist>
<varlistentry>
<term>Transfer function:</term>
<listitem>
<para>L' = L<superscript>1/2.6</superscript></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Inverse Transfer function:</term>
<listitem>
<para>L = L'<superscript>2.6</superscript></para>
</listitem>
</varlistentry>
</variablelist>
<para>Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709.</para>
</section>
<section id="col-smpte-240m"> <section id="col-smpte-240m">
<title>Colorspace SMPTE 240M (<constant>V4L2_COLORSPACE_SMPTE240M</constant>)</title> <title>Colorspace SMPTE 240M (<constant>V4L2_COLORSPACE_SMPTE240M</constant>)</title>
<para>The <xref linkend="smpte240m" /> standard was an interim standard used during <para>The <xref linkend="smpte240m" /> standard was an interim standard used during