94 lines · plain
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later2 3.. _colorimetry-controls:4 5*****************************6Colorimetry Control Reference7*****************************8 9The Colorimetry class includes controls for High Dynamic Range10imaging for representing colors in digital images and video. The11controls should be used for video and image encoding and decoding12as well as in HDMI receivers and transmitters.13 14Colorimetry Control IDs15-----------------------16 17.. _colorimetry-control-id:18 19``V4L2_CID_COLORIMETRY_CLASS (class)``20 The Colorimetry class descriptor. Calling21 :ref:`VIDIOC_QUERYCTRL` for this control will22 return a description of this control class.23 24``V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)``25 The Content Light Level defines upper bounds for the nominal target26 brightness light level of the pictures.27 28.. c:type:: v4l2_ctrl_hdr10_cll_info29 30.. cssclass:: longtable31 32.. flat-table:: struct v4l2_ctrl_hdr10_cll_info33 :header-rows: 034 :stub-columns: 035 :widths: 1 1 236 37 * - __u1638 - ``max_content_light_level``39 - The upper bound for the maximum light level among all individual40 samples for the pictures of a video sequence, cd/m\ :sup:`2`.41 When equal to 0 no such upper bound is present.42 * - __u1643 - ``max_pic_average_light_level``44 - The upper bound for the maximum average light level among the45 samples for any individual picture of a video sequence,46 cd/m\ :sup:`2`. When equal to 0 no such upper bound is present.47 48``V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)``49 The mastering display defines the color volume (the color primaries,50 white point and luminance range) of a display considered to be the51 mastering display for the current video content.52 53.. c:type:: v4l2_ctrl_hdr10_mastering_display54 55.. cssclass:: longtable56 57.. flat-table:: struct v4l2_ctrl_hdr10_mastering_display58 :header-rows: 059 :stub-columns: 060 :widths: 1 1 261 62 * - __u1663 - ``display_primaries_x[3]``64 - Specifies the normalized x chromaticity coordinate of the color65 primary component c of the mastering display in increments of 0.00002.66 For describing the mastering display that uses Red, Green and Blue67 color primaries, index value c equal to 0 corresponds to the Green68 primary, c equal to 1 corresponds to Blue primary and c equal to 269 corresponds to the Red color primary.70 * - __u1671 - ``display_primaries_y[3]``72 - Specifies the normalized y chromaticity coordinate of the color73 primary component c of the mastering display in increments of 0.00002.74 For describing the mastering display that uses Red, Green and Blue75 color primaries, index value c equal to 0 corresponds to the Green76 primary, c equal to 1 corresponds to Blue primary and c equal to 277 corresponds to Red color primary.78 * - __u1679 - ``white_point_x``80 - Specifies the normalized x chromaticity coordinate of the white81 point of the mastering display in increments of 0.00002.82 * - __u1683 - ``white_point_y``84 - Specifies the normalized y chromaticity coordinate of the white85 point of the mastering display in increments of 0.00002.86 * - __u3287 - ``max_luminance``88 - Specifies the nominal maximum display luminance of the mastering89 display in units of 0.0001 cd/m\ :sup:`2`.90 * - __u3291 - ``min_luminance``92 - specifies the nominal minimum display luminance of the mastering93 display in units of 0.0001 cd/m\ :sup:`2`.94