Vsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetA/translations/zh_CN/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/zh_TW/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/it_IT/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/ja_JP/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/ko_KR/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetA/translations/sp_SP/userspace-api/media/v4l/ext-ctrls-colorimetrymodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh[/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rsthKubhtarget)}(h.. _colorimetry-controls:h]h}(h]h ]h"]h$]h&]refidcolorimetry-controlsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hColorimetry Control Referenceh]hColorimetry Control Reference}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hThe Colorimetry class includes controls for High Dynamic Range imaging for representing colors in digital images and video. The controls should be used for video and image encoding and decoding as well as in HDMI receivers and transmitters.h]hThe Colorimetry class includes controls for High Dynamic Range imaging for representing colors in digital images and video. The controls should be used for video and image encoding and decoding as well as in HDMI receivers and transmitters.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(hColorimetry Control IDsh]hColorimetry Control IDs}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(h.. _colorimetry-control-id:h]h}(h]h ]h"]h$]h&]hcolorimetry-control-iduh1hhKhhhhhhubhdefinition_list)}(hhh](hdefinition_list_item)}(h``V4L2_CID_COLORIMETRY_CLASS (class)`` The Colorimetry class descriptor. Calling :ref:`VIDIOC_QUERYCTRL` for this control will return a description of this control class. h](hterm)}(h&``V4L2_CID_COLORIMETRY_CLASS (class)``h]hliteral)}(hjh]h"V4L2_CID_COLORIMETRY_CLASS (class)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhKhj ubh definition)}(hhh]h)}(hThe Colorimetry class descriptor. Calling :ref:`VIDIOC_QUERYCTRL` for this control will return a description of this control class.h](h*The Colorimetry class descriptor. Calling }(hj.hhhNhNubh)}(h:ref:`VIDIOC_QUERYCTRL`h]hinline)}(hj8h]hVIDIOC_QUERYCTRL}(hj<hhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1j:hj6ubah}(h]h ]h"]h$]h&]refdoc-userspace-api/media/v4l/ext-ctrls-colorimetry refdomainjGreftyperef refexplicitrefwarn reftargetvidioc_queryctrluh1hhhhKhj.ubhB for this control will return a description of this control class.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj+ubah}(h]h ]h"]h$]h&]uh1j)hj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj )}(h``V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)`` The Content Light Level defines upper bounds for the nominal target brightness light level of the pictures. h](j)}(h0``V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)``h]j)}(hjwh]h,V4L2_CID_COLORIMETRY_HDR10_CLL_INFO (struct)}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjuubah}(h]h ]h"]h$]h&]uh1jhhhKhjqubj*)}(hhh]h)}(hkThe Content Light Level defines upper bounds for the nominal target brightness light level of the pictures.h]hkThe Content Light Level defines upper bounds for the nominal target brightness light level of the pictures.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j)hjqubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]jah ]h"]colorimetry-control-idah$]h&]uh1jhhhhhhhNexpect_referenced_by_name}jhsexpect_referenced_by_id}jhsubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single!v4l2_ctrl_hdr10_cll_info (C type)c.v4l2_ctrl_hdr10_cll_infohNtauh1jhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(hv4l2_ctrl_hdr10_cll_infoh]hdesc_signature_line)}(htype v4l2_ctrl_hdr10_cll_infoh](hdesc_sig_keyword)}(htypeh]htype}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjhhhhhKubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhhhKubh desc_name)}(hv4l2_ctrl_hdr10_cll_infoh]h desc_sig_name)}(hjh]hv4l2_ctrl_hdr10_cll_info}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhhhKubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1jsphinx_line_type declaratorhjhhhhhKubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhhhKhjhhubh desc_content)}(hhh]h}(h]h ]h"]h$]h&]uh1j*hjhhhhhKubeh}(h]h ](ctypeeh"]h$]h&]domainj8objtypej9desctypej9noindex noindexentrynocontentsentryuh1jhhhhhNhNubhtable)}(hhh](h)}(hstruct v4l2_ctrl_hdr10_cll_infoh]hstruct v4l2_ctrl_hdr10_cll_info}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjEubhtgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hjXubj\)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hjXubj\)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hjXubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h__u16h]h__u16}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``max_content_light_level``h]j)}(hjh]hmax_content_light_level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhK&hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hThe upper bound for the maximum light level among all individual samples for the pictures of a video sequence, cd/m\ :sup:`2`. When equal to 0 no such upper bound is present.h](huThe upper bound for the maximum light level among all individual samples for the pictures of a video sequence, cd/m }(hjhhhNhNubh superscript)}(h:sup:`2`h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh1. When equal to 0 no such upper bound is present.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj}ubj)}(hhh](j)}(hhh]h)}(h__u16h]h__u16}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK*hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``max_pic_average_light_level``h]j)}(hjh]hmax_pic_average_light_level}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhhhK+hj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hThe upper bound for the maximum average light level among the samples for any individual picture of a video sequence, cd/m\ :sup:`2`. When equal to 0 no such upper bound is present.h](h|The upper bound for the maximum average light level among the samples for any individual picture of a video sequence, cd/m }(hj,hhhNhNubj)}(h:sup:`2`h]h2}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubh1. When equal to 0 no such upper bound is present.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK,hj)ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1j{hjXubeh}(h]h ]h"]h$]h&]colsKuh1jVhjEubeh}(h]id1ah ] longtableah"]h$]h&]uh1jChhhhhNhNubj)}(hhh]j )}(h``V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)`` The mastering display defines the color volume (the color primaries, white point and luminance range) of a display considered to be the mastering display for the current video content. h](j)}(h9``V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)``h]j)}(hjvh]h5V4L2_CID_COLORIMETRY_HDR10_MASTERING_DISPLAY (struct)}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjtubah}(h]h ]h"]h$]h&]uh1jhhhK3hjpubj*)}(hhh]h)}(hThe mastering display defines the color volume (the color primaries, white point and luminance range) of a display considered to be the mastering display for the current video content.h]hThe mastering display defines the color volume (the color primaries, white point and luminance range) of a display considered to be the mastering display for the current video content.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1j)hjpubeh}(h]h ]h"]h$]h&]uh1jhhhK3hjmubah}(h]h ]h"]h$]h&]uh1jhhhhhhhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j*v4l2_ctrl_hdr10_mastering_display (C type)#c.v4l2_ctrl_hdr10_mastering_displayhNtauh1jhhhhhNhNubj)}(hhh](j)}(h!v4l2_ctrl_hdr10_mastering_displayh]j)}(h&type v4l2_ctrl_hdr10_mastering_displayh](j)}(hjh]htype}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhK5ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhK5ubj)}(h!v4l2_ctrl_hdr10_mastering_displayh]j)}(hjh]h!v4l2_ctrl_hdr10_mastering_display}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhhhK5ubeh}(h]h ]h"]h$]h&]hhjuh1jjjhjhhhhhK5ubah}(h]jah ](j"j#eh"]h$]h&]j'j()j)huh1jhhhK5hjhhubj+)}(hhh]h}(h]h ]h"]h$]h&]uh1j*hjhhhhhK5ubeh}(h]h ](j8typeeh"]h$]h&]j=j8j>jj?jj@jAjBuh1jhhhhhNhNubjD)}(hhh](h)}(h(struct v4l2_ctrl_hdr10_mastering_displayh]h(struct v4l2_ctrl_hdr10_mastering_display}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubjW)}(hhh](j\)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hj&ubj\)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hj&ubj\)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j[hj&ubj|)}(hhh](j)}(hhh](j)}(hhh]h)}(h__u16h]h__u16}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjMubah}(h]h ]h"]h$]h&]uh1jhjJubj)}(hhh]h)}(h``display_primaries_x[3]``h]j)}(hjih]hdisplay_primaries_x[3]}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&]uh1hhhhK?hjdubah}(h]h ]h"]h$]h&]uh1jhjJubj)}(hhh]h)}(hXuSpecifies the normalized x chromaticity coordinate of the color primary component c of the mastering display in increments of 0.00002. For describing the mastering display that uses Red, Green and Blue color primaries, index value c equal to 0 corresponds to the Green primary, c equal to 1 corresponds to Blue primary and c equal to 2 corresponds to the Red color primary.h]hXuSpecifies the normalized x chromaticity coordinate of the color primary component c of the mastering display in increments of 0.00002. For describing the mastering display that uses Red, Green and Blue color primaries, index value c equal to 0 corresponds to the Green primary, c equal to 1 corresponds to Blue primary and c equal to 2 corresponds to the Red color primary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjGubj)}(hhh](j)}(hhh]h)}(h__u16h]h__u16}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``display_primaries_y[3]``h]j)}(hjh]hdisplay_primaries_y[3]}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hXqSpecifies the normalized y chromaticity coordinate of the color primary component c of the mastering display in increments of 0.00002. For describing the mastering display that uses Red, Green and Blue color primaries, index value c equal to 0 corresponds to the Green primary, c equal to 1 corresponds to Blue primary and c equal to 2 corresponds to Red color primary.h]hXqSpecifies the normalized y chromaticity coordinate of the color primary component c of the mastering display in increments of 0.00002. For describing the mastering display that uses Red, Green and Blue color primaries, index value c equal to 0 corresponds to the Green primary, c equal to 1 corresponds to Blue primary and c equal to 2 corresponds to Red color primary.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjGubj)}(hhh](j)}(hhh]h)}(h__u16h]h__u16}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``white_point_x``h]j)}(hjh]h white_point_x}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hxSpecifies the normalized x chromaticity coordinate of the white point of the mastering display in increments of 0.00002.h]hxSpecifies the normalized x chromaticity coordinate of the white point of the mastering display in increments of 0.00002.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjGubj)}(hhh](j)}(hhh]h)}(h__u16h]h__u16}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjRubah}(h]h ]h"]h$]h&]uh1jhjOubj)}(hhh]h)}(h``white_point_y``h]j)}(hjnh]h white_point_y}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&]uh1hhhhKShjiubah}(h]h ]h"]h$]h&]uh1jhjOubj)}(hhh]h)}(hxSpecifies the normalized y chromaticity coordinate of the white point of the mastering display in increments of 0.00002.h]hxSpecifies the normalized y chromaticity coordinate of the white point of the mastering display in increments of 0.00002.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjGubj)}(hhh](j)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``max_luminance``h]j)}(hjh]h max_luminance}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKWhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hkSpecifies the nominal maximum display luminance of the mastering display in units of 0.0001 cd/m\ :sup:`2`.h](hbSpecifies the nominal maximum display luminance of the mastering display in units of 0.0001 cd/m }(hjhhhNhNubj)}(h:sup:`2`h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjGubj)}(hhh](j)}(hhh]h)}(h__u32h]h__u32}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h``min_luminance``h]j)}(hj.h]h min_luminance}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhhhK[hj)ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hkspecifies the nominal minimum display luminance of the mastering display in units of 0.0001 cd/m\ :sup:`2`.h](hbspecifies the nominal minimum display luminance of the mastering display in units of 0.0001 cd/m }(hjLhhhNhNubj)}(h:sup:`2`h]h2}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjLubh.}(hjLhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK\hjIubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1j{hj&ubeh}(h]h ]h"]h$]h&]colsKuh1jVhjubeh}(h]id2ah ] longtableah"]h$]h&]uh1jChhhhhNhNubeh}(h]colorimetry-control-idsah ]h"]colorimetry control idsah$]h&]uh1hhhhhhhhKubeh}(h](colorimetry-control-referenceheh ]h"](colorimetry control referencecolorimetry-controlseh$]h&]uh1hhhhhhhhKj}jhsj}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(h]haj]haunameids}(jhjjjjjju nametypes}(jjjjuh}(hhjhjhjjjjjjjgjEjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h:Hyperlink target "colorimetry-controls" is not referenced.}hj-sbah}(h]h ]h"]h$]h&]uh1hhj*ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1j(ubj))}(hhh]h)}(hhh]h