!sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget4/translations/zh_CN/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/zh_TW/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/it_IT/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/ja_JP/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/ko_KR/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/pt_BR/userspace-api/media/v4l/v4l2-ispmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget4/translations/sp_SP/userspace-api/media/v4l/v4l2-ispmodnameN 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:spacepreserveuh1hhhhhhN/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp.rsthKubhtarget)}(h .. _v4l2-isp:h]h}(h]h ]h"]h$]h&]refidv4l2-ispuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hGeneric V4L2 ISP formatsh]hGeneric V4L2 ISP formats}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hGeneric ISP formats are metadata formats that define a mechanism to pass ISP parameters and statistics between userspace and drivers in V4L2 buffers. They are designed to allow extending them in a backward-compatible way.h]hGeneric ISP formats are metadata formats that define a mechanism to pass ISP parameters and statistics between userspace and drivers in V4L2 buffers. They are designed to allow extending them in a backward-compatible way.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(hISP parametersh]hISP parameters}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hXThe generic ISP configuration parameters format is realized by a defining a single C structure that contains a header, followed by a binary buffer where userspace programs a variable number of ISP configuration data block, one for each supported ISP feature.h]hXThe generic ISP configuration parameters format is realized by a defining a single C structure that contains a header, followed by a binary buffer where userspace programs a variable number of ISP configuration data block, one for each supported ISP feature.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXEThe :c:type:`v4l2_isp_buffer` structure defines the buffer header which is followed by a binary buffer of ISP configuration data. Userspace shall correctly populate the buffer header with the serialization format version and with the size (in bytes) of the binary data buffer where it will store the ISP blocks configuration.h](hThe }(hjhhhNhNubh)}(h:c:type:`v4l2_isp_buffer`h]hliteral)}(hj$h]hv4l2_isp_buffer}(hj(hhhNhNubah}(h]h ](xrefcc-typeeh"]h$]h&]uh1j&hj"ubah}(h]h ]h"]h$]h&]refdoc userspace-api/media/v4l/v4l2-isp refdomainj3reftypetype refexplicitrefwarn reftargetv4l2_isp_bufferuh1hhhhKhjubhX( structure defines the buffer header which is followed by a binary buffer of ISP configuration data. Userspace shall correctly populate the buffer header with the serialization format version and with the size (in bytes) of the binary data buffer where it will store the ISP blocks configuration.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hEach *ISP configuration block* is preceded by a header implemented by the :c:type:`v4l2_isp_block_header` structure, followed by the configuration parameters for that specific block, defined by the ISP driver specific data types.h](hEach }(hjQhhhNhNubhemphasis)}(h*ISP configuration block*h]hISP configuration block}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jYhjQubh, is preceded by a header implemented by the }(hjQhhhNhNubh)}(h:c:type:`v4l2_isp_block_header`h]j')}(hjoh]hv4l2_isp_block_header}(hjqhhhNhNubah}(h]h ](j2j3c-typeeh"]h$]h&]uh1j&hjmubah}(h]h ]h"]h$]h&]refdocj? refdomainj3reftypetype refexplicitrefwarnjEv4l2_isp_block_headeruh1hhhhKhjQubh| structure, followed by the configuration parameters for that specific block, defined by the ISP driver specific data types.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hUserspace applications are responsible for correctly populating each block's header fields (type, flags and size) and the block-specific parameters.h]hUserspace applications are responsible for correctly populating each block’s header fields (type, flags and size) and the block-specific parameters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(h:ISP parameters block enabling, disabling and configurationh]h:ISP parameters block enabling, disabling and configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK$ubh)}(hWhen userspace wants to configure and enable an ISP block it shall fully populate the block configuration and set the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE bit in the block header's `flags` field.h](hWhen userspace wants to configure and enable an ISP block it shall fully populate the block configuration and set the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE bit in the block header’s }(hjhhhNhNubhtitle_reference)}(h`flags`h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh field.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK&hjhhubh)}(hWhen userspace simply wants to disable an ISP block the V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bit should be set in block header's `flags` field. Drivers accept a configuration parameters block with no additional data after the header in this case.h](hWhen userspace simply wants to disable an ISP block the V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bit should be set in block header’s }(hjhhhNhNubj)}(h`flags`h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhn field. Drivers accept a configuration parameters block with no additional data after the header in this case.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK*hjhhubh)}(hIf the configuration of an already active ISP block has to be updated, userspace shall fully populate the ISP block parameters and omit setting the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE and V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bits in the header's `flags` field.h](hIf the configuration of an already active ISP block has to be updated, userspace shall fully populate the ISP block parameters and omit setting the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE and V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bits in the header’s }(hjhhhNhNubj)}(h`flags`h]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh field.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK/hjhhubh)}(hSetting both the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE and V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bits in the flags field is not allowed and returns an error.h]hSetting both the V4L2_ISP_PARAMS_FL_BLOCK_ENABLE and V4L2_ISP_PARAMS_FL_BLOCK_DISABLE bits in the flags field is not allowed and returns an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjhhubh)}(h}Extension to the parameters format can be implemented by adding new blocks definition without invalidating the existing ones.h]h}Extension to the parameters format can be implemented by adding new blocks definition without invalidating the existing ones.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubeh}(h]9isp-parameters-block-enabling-disabling-and-configurationah ]h"]:isp parameters block enabling, disabling and configurationah$]h&]uh1hhhhhhhhK$ubeh}(h]isp-parametersah ]h"]isp parametersah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hISP statisticsh]hISP statistics}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChhhhhKhjChhubh)}(hXExtensible statistics buffers have :c:type:`v4l2_isp_buffer` header followed by a binary buffer of ISP statistics data. ISP drivers populate the buffer header with the serialization format version and with the size (in bytes) of the binary data buffer where ISP statistics data are serialized. Applications shall validate that the serialization format version matches the expected one and that the buffer size doesn't exceed the maximum size for a statistics buffer as declared by the driver's uAPI header.h](h#Extensible statistics buffers have }(hjbhhhNhNubh)}(h:c:type:`v4l2_isp_buffer`h]j')}(hjlh]hv4l2_isp_buffer}(hjnhhhNhNubah}(h]h ](j2j3c-typeeh"]h$]h&]uh1j&hjjubah}(h]h ]h"]h$]h&]refdocj? refdomainj3reftypetype refexplicitrefwarnjEv4l2_isp_bufferuh1hhhhKChjbubhX header followed by a binary buffer of ISP statistics data. ISP drivers populate the buffer header with the serialization format version and with the size (in bytes) of the binary data buffer where ISP statistics data are serialized. Applications shall validate that the serialization format version matches the expected one and that the buffer size doesn’t exceed the maximum size for a statistics buffer as declared by the driver’s uAPI header.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKChjChhubh)}(hX Each *ISP statistics block* is preceded by a header implemented by the :c:type:`v4l2_isp_block_header` structure, followed by the statistics data for that specific block. The driver might optionally report platform-specific flags associated with each statistics block.h](hEach }(hjhhhNhNubjZ)}(h*ISP statistics block*h]hISP statistics block}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jYhjubh, is preceded by a header implemented by the }(hjhhhNhNubh)}(h:c:type:`v4l2_isp_block_header`h]j')}(hjh]hv4l2_isp_block_header}(hjhhhNhNubah}(h]h ](j2j3c-typeeh"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]refdocj? refdomainj3reftypetype refexplicitrefwarnjEv4l2_isp_block_headeruh1hhhhKKhjubh structure, followed by the statistics data for that specific block. The driver might optionally report platform-specific flags associated with each statistics block.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKKhjChhubh)}(hApplications inspect the statistics block type as reported in the header and validates the reported size matches the block's expected size before accessing the ISP statistics data.h]hApplications inspect the statistics block type as reported in the header and validates the reported size matches the block’s expected size before accessing the ISP statistics data.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjChhubh)}(h}Extension to the statistics format can be implemented by adding new blocks definition without invalidating the existing ones.h]h}Extension to the statistics format can be implemented by adding new blocks definition without invalidating the existing ones.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjChhubeh}(h]isp-statisticsah ]h"]isp statisticsah$]h&]uh1hhhhhhhhKhjubh)}(h **Members**h]j)}(hj8h]hMembers}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKDhjubj)}(hhh](j)}(hC``type`` The parameters or statistics block type (driver-specific) h](j)}(h``type``h]j')}(hjWh]htype}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjUubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK:hjQubj)}(hhh]h)}(h9The parameters or statistics block type (driver-specific)h]h9The parameters or statistics block type (driver-specific)}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhK:hjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhK:hjNubj)}(h5``flags`` A bitmask of block flags (driver-specific) h](j)}(h ``flags``h]j')}(hjh]hflags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK;hjubj)}(hhh]h)}(h*A bitmask of block flags (driver-specific)h]h*A bitmask of block flags (driver-specific)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK;hjNubj)}(h<``size`` Size (in bytes) of the block, including this headerh](j)}(h``size``h]j')}(hjh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK;hjubj)}(hhh]h)}(h3Size (in bytes) of the block, including this headerh]h3Size (in bytes) of the block, including this header}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK field specifies the size of the block, including this header.}(hj1hhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKAhjhhubh)}(hXThe **flags** field is a bitmask of per-block flags. If a block is used for configuration parameters this field can be a combination of V4L2_ISP_PARAMS_FL_* and driver-specific flags. If a block is used for statistics this fields is used to report optional driver-specific flags, if any.h](hThe }(hjdhhhNhNubj)}(h **flags**h]hflags}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubhX field is a bitmask of per-block flags. If a block is used for configuration parameters this field can be a combination of V4L2_ISP_PARAMS_FL_* and driver-specific flags. If a block is used for statistics this fields is used to report optional driver-specific flags, if any.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKEhjhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j&v4l2_isp_params_block_header (C macro)c.v4l2_isp_params_block_headerhNtauh1j hjhhhjhNubj)}(hhh](j#)}(hv4l2_isp_params_block_headerh]j))}(hv4l2_isp_params_block_headerh]jR)}(hv4l2_isp_params_block_headerh]jX)}(hjh]hv4l2_isp_params_block_header}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jWhjubah}(h]h ](jjjkeh"]h$]h&]hhuh1jQhjhhht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKSubah}(h]h ]h"]h$]h&]hhjuuh1j(jvjwhjhhhjhKSubah}(h]jah ](j{j|eh"]h$]h&]jj)jhuh1j"hjhKShjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhKSubeh}(h]h ](j3macroeh"]h$]h&]jj3jjjjjjjuh1jhhhjhjhNubh)}(h ``v4l2_isp_params_block_header``h]j')}(hjh]hv4l2_isp_params_block_header}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKUhjhhubh block_quote)}(h V4L2 extensible parameters block header **Description** Compatibility with existing users of v4l2_isp_params_block_header which pre-date the introduction of v4l2_isp_block_header. h](j)}(h(V4L2 extensible parameters block header h]h)}(h'V4L2 extensible parameters block headerh]h'V4L2 extensible parameters block header}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKShjubah}(h]h ]h"]h$]h&]uh1jhjhKShjubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKUhjubh)}(h{Compatibility with existing users of v4l2_isp_params_block_header which pre-date the introduction of v4l2_isp_block_header.h]h{Compatibility with existing users of v4l2_isp_params_block_header which pre-date the introduction of v4l2_isp_block_header.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKThjubeh}(h]h ]h"]h$]h&]uh1jhjhKShjhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](jv4l2_isp_buffer (C struct)c.v4l2_isp_bufferhNtauh1j hjhhhjhNubj)}(hhh](j#)}(hv4l2_isp_bufferh]j))}(hstruct v4l2_isp_bufferh](j/)}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]j;ah"]h$]h&]uh1j.hjKhhht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKZubjA)}(h h]h }(hj]hhhNhNubah}(h]h ]jMah"]h$]h&]uh1j@hjKhhhj\hKZubjR)}(hv4l2_isp_bufferh]jX)}(hjIh]hv4l2_isp_buffer}(hjohhhNhNubah}(h]h ]jcah"]h$]h&]uh1jWhjkubah}(h]h ](jjjkeh"]h$]h&]hhuh1jQhjKhhhj\hKZubeh}(h]h ]h"]h$]h&]hhjuuh1j(jvjwhjGhhhj\hKZubah}(h]jBah ](j{j|eh"]h$]h&]jj)jhuh1j"hj\hKZhjDhhubj)}(hhh]h)}(hV4L2 extensible bufferh]hV4L2 extensible buffer}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK[hjhhubah}(h]h ]h"]h$]h&]uh1jhjDhhhj\hKZubeh}(h]h ](j3structeh"]h$]h&]jj3jjjjjjjuh1jhhhjhjhNubj)}(hX-**Definition**:: struct v4l2_isp_buffer { __u32 version; __u32 data_size; __u8 data[]; }; **Members** ``version`` The extensible buffer version (driver-specific) ``data_size`` The data effective size, excluding this header ``data`` The configuration or statistics datah](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK_hjubj&)}(hTstruct v4l2_isp_buffer { __u32 version; __u32 data_size; __u8 data[]; };h]hTstruct v4l2_isp_buffer { __u32 version; __u32 data_size; __u8 data[]; };}hjsbah}(h]h ]h"]h$]h&]hhuh1j%ht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKahjubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKghjubj)}(hhh](j)}(h<``version`` The extensible buffer version (driver-specific) h](j)}(h ``version``h]j')}(hjh]hversion}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK]hjubj)}(hhh]h)}(h/The extensible buffer version (driver-specific)h]h/The extensible buffer version (driver-specific)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK]hjubj)}(h=``data_size`` The data effective size, excluding this header h](j)}(h ``data_size``h]j')}(hj7h]h data_size}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1j&hj5ubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK^hj1ubj)}(hhh]h)}(h.The data effective size, excluding this headerh]h.The data effective size, excluding this header}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhK^hjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhK^hjubj)}(h-``data`` The configuration or statistics datah](j)}(h``data``h]j')}(hjph]hdata}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1j&hjnubah}(h]h ]h"]h$]h&]uh1jht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK^hjjubj)}(hhh]h)}(h$The configuration or statistics datah]h$The configuration or statistics data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK_hjubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhjhK^hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhjhNubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKbhjhhubh)}(hThis structure contains ISP configuration parameters or ISP hardware statistics serialized into a data buffer. Each block is represented by a block-specific structure which contains a :c:type:`v4l2_isp_block_header` entry as first member.h](hThis structure contains ISP configuration parameters or ISP hardware statistics serialized into a data buffer. Each block is represented by a block-specific structure which contains a }(hjhhhNhNubh)}(h:c:type:`v4l2_isp_block_header`h]j')}(hjh]hv4l2_isp_block_header}(hjhhhNhNubah}(h]h ](j2j3c-typeeh"]h$]h&]uh1j&hjubah}(h]h ]h"]h$]h&]refdocj? refdomainj3reftypetype refexplicitrefwarn c:parent_keysphinx.domains.c LookupKey)}data]sbjEv4l2_isp_block_headeruh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhK_hjubh entry as first member.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhK_hjhhubh)}(hXWhen used for ISP parameters, userspace populates the **data** buffer with configuration parameters for the blocks that it intends to configure. As a consequence, the data buffer effective size changes according to the number of ISP blocks that userspace intends to configure.h](h6When used for ISP parameters, userspace populates the }(hj hhhNhNubj)}(h**data**h]hdata}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh buffer with configuration parameters for the blocks that it intends to configure. As a consequence, the data buffer effective size changes according to the number of ISP blocks that userspace intends to configure.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKdhjhhubh)}(hWhen used to report ISP statistics, the driver populates the **data** buffer with statistics for each supported measurement block.h](h=When used to report ISP statistics, the driver populates the }(hj$ hhhNhNubj)}(h**data**h]hdata}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ ubh= buffer with statistics for each supported measurement block.}(hj$ hhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKihjhhubh)}(hX|The buffer is versioned by the **version** field to allow modifying and extending its definition. The writer shall populate the **version** field to inform the reader about the version it intends to use. The reader will parse and handle the **data** buffer according to the data layout specific to the indicated version and return an error if the desired version is not supported.h](hThe buffer is versioned by the }(hjE hhhNhNubj)}(h **version**h]hversion}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE ubhV field to allow modifying and extending its definition. The writer shall populate the }(hjE hhhNhNubj)}(h **version**h]hversion}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE ubhf field to inform the reader about the version it intends to use. The reader will parse and handle the }(hjE hhhNhNubj)}(h**data**h]hdata}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjE ubh buffer according to the data layout specific to the indicated version and return an error if the desired version is not supported.}(hjE hhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKlhjhhubh)}(hFor each ISP block, a block-specific structure is appended to the **data** buffer, one after the other without gaps in between. The writer shall populate the **data_size** field with the effective size, in bytes, of the **data** buffer.h](hBFor each ISP block, a block-specific structure is appended to the }(hj hhhNhNubj)}(h**data**h]hdata}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubhT buffer, one after the other without gaps in between. The writer shall populate the }(hj hhhNhNubj)}(h **data_size**h]h data_size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh1 field with the effective size, in bytes, of the }(hj hhhNhNubj)}(h**data**h]hdata}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh buffer.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKshjhhubj )}(hhh]h}(h]h ]h"]h$]h&]entries](j v4l2_isp_params_buffer (C macro)c.v4l2_isp_params_bufferhNtauh1j hjhhhjhNubj)}(hhh](j#)}(hv4l2_isp_params_bufferh]j))}(hv4l2_isp_params_bufferh]jR)}(hv4l2_isp_params_bufferh]jX)}(hj h]hv4l2_isp_params_buffer}(hj hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jWhj ubah}(h]h ](jjjkeh"]h$]h&]hhuh1jQhj hhht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKubah}(h]h ]h"]h$]h&]hhjuuh1j(jvjwhj hhhj hKubah}(h]j ah ](j{j|eh"]h$]h&]jj)jhuh1j"hj hKhj hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj hhhj hKubeh}(h]h ](j3macroeh"]h$]h&]jj3jj jj jjjuh1jhhhjhjhNubh)}(h``v4l2_isp_params_buffer``h]j')}(hj h]hv4l2_isp_params_buffer}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j&hj ubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKhjhhubj)}(h V4L2 extensible parameters compatibility **Description** Compatibility with existing users of v4l2_isp_params_buffer which pre-date the introduction of v4l2_isp_buffer. h](j)}(h)V4L2 extensible parameters compatibility h]h)}(h(V4L2 extensible parameters compatibilityh]h(V4L2 extensible parameters compatibility}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKhj8 ubah}(h]h ]h"]h$]h&]uh1jhjJ hKhj4 ubh)}(h**Description**h]j)}(hjS h]h Description}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQ ubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKhj4 ubh)}(hoCompatibility with existing users of v4l2_isp_params_buffer which pre-date the introduction of v4l2_isp_buffer.h]hoCompatibility with existing users of v4l2_isp_params_buffer which pre-date the introduction of v4l2_isp_buffer.}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1hht/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/v4l2-isp:90: ./include/uapi/linux/media/v4l2-isp.hhKhj4 ubeh}(h]h ]h"]h$]h&]uh1jhjJ hKhjhhubeh}(h]v4l2-isp-uapi-data-typesah ]h"]v4l2 isp uapi data typesah$]h&]uh1hhhhhhhhKXubeh}(h](generic-v4l2-isp-formatsheh ]h"](generic v4l2 isp formatsv4l2-ispeh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}j hsexpect_referenced_by_id}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_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_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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]hasnameids}(j hj j j@j=j8j5jjj j u nametypes}(j j j@j8jj uh}(hhj hj=hj5jjjCj jjj$jjjjjBjGj j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h.Hyperlink target "v4l2-isp" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehnjlineKuh1j uba transformerN include_log] decorationNhhub.