14e4053a2SStanimir Varbanov.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 24e4053a2SStanimir Varbanov 34e4053a2SStanimir Varbanov.. _colorimetry-controls: 44e4053a2SStanimir Varbanov 54e4053a2SStanimir Varbanov***************************** 64e4053a2SStanimir VarbanovColorimetry Control Reference 74e4053a2SStanimir Varbanov***************************** 84e4053a2SStanimir Varbanov 94e4053a2SStanimir VarbanovThe Colorimetry class includes controls for High Dynamic Range 104e4053a2SStanimir Varbanovimaging for representing colors in digital images and video. The 114e4053a2SStanimir Varbanovcontrols should be used for video and image encoding and decoding 124e4053a2SStanimir Varbanovas well as in HDMI receivers and transmitters. 134e4053a2SStanimir Varbanov 144e4053a2SStanimir VarbanovColorimetry Control IDs 154e4053a2SStanimir Varbanov----------------------- 164e4053a2SStanimir Varbanov 174e4053a2SStanimir Varbanov.. _colorimetry-control-id: 184e4053a2SStanimir Varbanov 194e4053a2SStanimir Varbanov``V4L2_CID_COLORIMETRY_CLASS (class)`` 204e4053a2SStanimir Varbanov The Colorimetry class descriptor. Calling 214e4053a2SStanimir Varbanov :ref:`VIDIOC_QUERYCTRL` for this control will 224e4053a2SStanimir Varbanov return a description of this control class. 23*5f8beb7dSStanimir Varbanov 24*5f8beb7dSStanimir Varbanov``V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)`` 25*5f8beb7dSStanimir Varbanov The Content Light Level defines upper bounds for the nominal target 26*5f8beb7dSStanimir Varbanov brightness light level of the pictures. 27*5f8beb7dSStanimir Varbanov 28*5f8beb7dSStanimir Varbanov.. c:type:: v4l2_ctrl_hdr10_cll_info 29*5f8beb7dSStanimir Varbanov 30*5f8beb7dSStanimir Varbanov.. cssclass:: longtable 31*5f8beb7dSStanimir Varbanov 32*5f8beb7dSStanimir Varbanov.. flat-table:: struct v4l2_ctrl_hdr10_cll_info 33*5f8beb7dSStanimir Varbanov :header-rows: 0 34*5f8beb7dSStanimir Varbanov :stub-columns: 0 35*5f8beb7dSStanimir Varbanov :widths: 1 1 2 36*5f8beb7dSStanimir Varbanov 37*5f8beb7dSStanimir Varbanov * - __u16 38*5f8beb7dSStanimir Varbanov - ``max_content_light_level`` 39*5f8beb7dSStanimir Varbanov - The upper bound for the maximum light level among all individual 40*5f8beb7dSStanimir Varbanov samples for the pictures of a video sequence, cd/m\ :sup:`2`. 41*5f8beb7dSStanimir Varbanov When equal to 0 no such upper bound is present. 42*5f8beb7dSStanimir Varbanov * - __u16 43*5f8beb7dSStanimir Varbanov - ``max_pic_average_light_level`` 44*5f8beb7dSStanimir Varbanov - The upper bound for the maximum average light level among the 45*5f8beb7dSStanimir Varbanov samples for any individual picture of a video sequence, 46*5f8beb7dSStanimir Varbanov cd/m\ :sup:`2`. When equal to 0 no such upper bound is present. 47*5f8beb7dSStanimir Varbanov 48*5f8beb7dSStanimir Varbanov``V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)`` 49*5f8beb7dSStanimir Varbanov The mastering display defines the color volume (the color primaries, 50*5f8beb7dSStanimir Varbanov white point and luminance range) of a display considered to be the 51*5f8beb7dSStanimir Varbanov mastering display for the current video content. 52*5f8beb7dSStanimir Varbanov 53*5f8beb7dSStanimir Varbanov.. c:type:: v4l2_ctrl_hdr10_mastering_display 54*5f8beb7dSStanimir Varbanov 55*5f8beb7dSStanimir Varbanov.. cssclass:: longtable 56*5f8beb7dSStanimir Varbanov 57*5f8beb7dSStanimir Varbanov.. flat-table:: struct v4l2_ctrl_hdr10_mastering_display 58*5f8beb7dSStanimir Varbanov :header-rows: 0 59*5f8beb7dSStanimir Varbanov :stub-columns: 0 60*5f8beb7dSStanimir Varbanov :widths: 1 1 2 61*5f8beb7dSStanimir Varbanov 62*5f8beb7dSStanimir Varbanov * - __u16 63*5f8beb7dSStanimir Varbanov - ``display_primaries_x[3]`` 64*5f8beb7dSStanimir Varbanov - Specifies the normalized x chromaticity coordinate of the color 65*5f8beb7dSStanimir Varbanov primary component c of the mastering display in increments of 0.00002. 66*5f8beb7dSStanimir Varbanov For describing the mastering display that uses Red, Green and Blue 67*5f8beb7dSStanimir Varbanov color primaries, index value c equal to 0 corresponds to the Green 68*5f8beb7dSStanimir Varbanov primary, c equal to 1 corresponds to Blue primary and c equal to 2 69*5f8beb7dSStanimir Varbanov corresponds to the Red color primary. 70*5f8beb7dSStanimir Varbanov * - __u16 71*5f8beb7dSStanimir Varbanov - ``display_primaries_y[3]`` 72*5f8beb7dSStanimir Varbanov - Specifies the normalized y chromaticity coordinate of the color 73*5f8beb7dSStanimir Varbanov primary component c of the mastering display in increments of 0.00002. 74*5f8beb7dSStanimir Varbanov For describing the mastering display that uses Red, Green and Blue 75*5f8beb7dSStanimir Varbanov color primaries, index value c equal to 0 corresponds to the Green 76*5f8beb7dSStanimir Varbanov primary, c equal to 1 corresponds to Blue primary and c equal to 2 77*5f8beb7dSStanimir Varbanov corresponds to Red color primary. 78*5f8beb7dSStanimir Varbanov * - __u16 79*5f8beb7dSStanimir Varbanov - ``white_point_x`` 80*5f8beb7dSStanimir Varbanov - Specifies the normalized x chromaticity coordinate of the white 81*5f8beb7dSStanimir Varbanov point of the mastering display in increments of 0.00002. 82*5f8beb7dSStanimir Varbanov * - __u16 83*5f8beb7dSStanimir Varbanov - ``white_point_y`` 84*5f8beb7dSStanimir Varbanov - Specifies the normalized y chromaticity coordinate of the white 85*5f8beb7dSStanimir Varbanov point of the mastering display in increments of 0.00002. 86*5f8beb7dSStanimir Varbanov * - __u32 87*5f8beb7dSStanimir Varbanov - ``max_luminance`` 88*5f8beb7dSStanimir Varbanov - Specifies the nominal maximum display luminance of the mastering 89*5f8beb7dSStanimir Varbanov display in units of 0.0001 cd/m\ :sup:`2`. 90*5f8beb7dSStanimir Varbanov * - __u32 91*5f8beb7dSStanimir Varbanov - ``min_luminance`` 92*5f8beb7dSStanimir Varbanov - specifies the nominal minimum display luminance of the mastering 93*5f8beb7dSStanimir Varbanov display in units of 0.0001 cd/m\ :sup:`2`. 94