esphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget8/translations/zh_CN/userspace-api/media/v4l/metafmt-d4xxmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/zh_TW/userspace-api/media/v4l/metafmt-d4xxmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/it_IT/userspace-api/media/v4l/metafmt-d4xxmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ja_JP/userspace-api/media/v4l/metafmt-d4xxmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ko_KR/userspace-api/media/v4l/metafmt-d4xxmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/sp_SP/userspace-api/media/v4l/metafmt-d4xxmodnameN 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:spacepreserveuh1hhhhhhR/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/metafmt-d4xx.rsthKubhtarget)}(h.. _v4l2-meta-fmt-d4xx:h]h}(h]h ]h"]h$]h&]refidv4l2-meta-fmt-d4xxuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hV4L2_META_FMT_D4XX ('D4XX')h]hV4L2_META_FMT_D4XX (‘D4XX’)}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hIntel D4xx UVC Cameras Metadatah]hIntel D4xx UVC Cameras Metadata}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(h Descriptionh]h Description}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh)}(hXhIntel D4xx (D435, D455 and others) cameras include per-frame metadata in their UVC payload headers, following the Microsoft(R) UVC extension proposal [1_]. That means, that the private D4XX metadata, following the standard UVC header, is organised in blocks. D4XX cameras implement several standard block types, proposed by Microsoft, and several proprietary ones. Supported standard metadata types are MetadataId_CaptureStats (ID 3), MetadataId_CameraExtrinsics (ID 4), and MetadataId_CameraIntrinsics (ID 5). For their description see [1_]. This document describes proprietary metadata types, used by D4xx cameras.h](hIntel D4xx (D435, D455 and others) cameras include per-frame metadata in their UVC payload headers, following the Microsoft(R) UVC extension proposal [}(hhhhhNhNubh reference)}(h1_h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]name1hid1uh1jhhresolvedKubhX]. That means, that the private D4XX metadata, following the standard UVC header, is organised in blocks. D4XX cameras implement several standard block types, proposed by Microsoft, and several proprietary ones. Supported standard metadata types are MetadataId_CaptureStats (ID 3), MetadataId_CameraExtrinsics (ID 4), and MetadataId_CameraIntrinsics (ID 5). For their description see [}(hhhhhNhNubj)}(h1_h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]namejhjuh1jhhjKubhL]. This document describes proprietary metadata types, used by D4xx cameras.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hX V4L2_META_FMT_D4XX buffers follow the metadata buffer layout of V4L2_META_FMT_UVC with the only difference, that it also includes proprietary payload header data. D4xx cameras use bulk transfers and only send one payload per frame, therefore their headers cannot be larger than 255 bytes.h]hX V4L2_META_FMT_D4XX buffers follow the metadata buffer layout of V4L2_META_FMT_UVC with the only difference, that it also includes proprietary payload header data. D4xx cameras use bulk transfers and only send one payload per frame, therefore their headers cannot be larger than 255 bytes.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hubah}(h]h ]h"]h$]h&]uh1jhj;ubj)}(hhh]h)}(h 0x80000000h]h 0x80000000}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjUubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Sizeh]h __u32 Size}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjuubah}(h]h ]h"]h$]h&]uh1jhjrubj)}(hhh]h)}(h5Size in bytes, include ID (all protocol versions: 60)h]h5Size in bytes, include ID (all protocol versions: 60)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Versionh]h __u32 Version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hVersion of this structure. The documentation herein covers versions 1, 2 and 3. The version number will be incremented when new fields are added.h]hVersion of this structure. The documentation herein covers versions 1, 2 and 3. The version number will be incremented when new fields are added.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Flagsh]h __u32 Flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h"A bitmask of flags: see [2_] belowh](hA bitmask of flags: see [}(hjhhhNhNubj)}(h2_h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]name2hid2uh1jhjjKubh] below}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Gainh]h __u32 Gain}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hj/ubah}(h]h ]h"]h$]h&]uh1jhj,ubj)}(hhh]h)}(hZGain value in internal units, same as the V4L2_CID_GAIN control, used to capture the frameh]hZGain value in internal units, same as the V4L2_CID_GAIN control, used to capture the frame}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjFubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Exposureh]h__u32 Exposure}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjfubah}(h]h ]h"]h$]h&]uh1jhjcubj)}(hhh]h)}(h9Exposure time (in microseconds) used to capture the frameh]h9Exposure time (in microseconds) used to capture the frame}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hj}ubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Laser powerh]h__u32 Laser power}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h 0: manual; 1: automatic exposureh]h 0: manual; 1: automatic exposure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Exposure priorityh]h__u32 Exposure priority}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h0Exposure priority value: 0 - constant frame rateh]h0Exposure priority value: 0 - constant frame rate}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 AE ROI lefth]h__u32 AE ROI left}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjBubah}(h]h ]h"]h$]h&]uh1jhj?ubj)}(hhh]h)}(hLeft border of the AE Region of Interest (all ROI values are in pixels and lie between 0 and maximum width or height respectively)h]hLeft border of the AE Region of Interest (all ROI values are in pixels and lie between 0 and maximum width or height respectively)}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjYubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 AE ROI righth]h__u32 AE ROI right}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjyubah}(h]h ]h"]h$]h&]uh1jhjvubj)}(hhh]h)}(h)Right border of the AE Region of Interesth]h)Right border of the AE Region of Interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjubah}(h]h ]h"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 AE ROI toph]h__u32 AE ROI top}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h'Top border of the AE Region of Interesth]h'Top border of the AE Region of Interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 AE ROI bottomh]h__u32 AE ROI bottom}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h*Bottom border of the AE Region of Interesth]h*Bottom border of the AE Region of Interest}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Preseth]h __u32 Preset}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h=Preset selector value, default: 0, unless changed by the userh]h=Preset selector value, default: 0, unless changed by the user}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h:__u8 Emitter mode (v3 only) (__u32 Laser mode for v1) [8_]h](h7__u8 Emitter mode (v3 only) (__u32 Laser mode for v1) [}(hjXhhhNhNubj)}(h8_h]h8}(hj`hhhNhNubah}(h]h ]h"]h$]h&]name8hid8uh1jhjXjKubh]}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKMhjUubah}(h]h ]h"]h$]h&]uh1jhjRubj)}(hhh]h)}(h.0: off, 1: on, same as __u32 Laser mode for v1h]h.0: off, 1: on, same as __u32 Laser mode for v1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjubah}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u8 RFU byte (v3 only)h]h__u8 RFU byte (v3 only)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hSpare byte for future useh]hSpare byte for future use}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u16 LED Power (v3 only)h]h__u16 LED Power (v3 only)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h Led power value 0-360 (F416 SKU)h]h Led power value 0-360 (F416 SKU)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]j)}(hhh]h)}(h:cspan:`1` *Capture Timing*h](h }(hjhhhNhNubj)}(h*Capture Timing*h]hCapture Timing}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhhhKShjubah}(h]h ]h"]h$]h&]morecolsKuh1jhj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 IDh]h__u32 ID}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThj>ubah}(h]h ]h"]h$]h&]uh1jhj;ubj)}(hhh]h)}(h 0x80000001h]h 0x80000001}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjUubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Sizeh]h __u32 Size}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjuubah}(h]h ]h"]h$]h&]uh1jhjrubj)}(hhh]h)}(h5Size in bytes, include ID (all protocol versions: 40)h]h5Size in bytes, include ID (all protocol versions: 40)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Versionh]h __u32 Version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(hVersion of this structure. The documentation herein corresponds to version xxx. The version number will be incremented when new fields are added.h]hVersion of this structure. The documentation herein corresponds to version xxx. The version number will be incremented when new fields are added.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Flagsh]h __u32 Flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h"A bitmask of flags: see [3_] belowh](hA bitmask of flags: see [}(hjhhhNhNubj)}(h3_h]h3}(hjhhhNhNubah}(h]h ]h"]h$]h&]name3hid3uh1jhjjKubh] below}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK]hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Frame counterh]h__u32 Frame counter}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hj/ubah}(h]h ]h"]h$]h&]uh1jhj,ubj)}(hhh]h)}(h Monotonically increasing counterh]h Monotonically increasing counter}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hjFubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Optical timeh]h__u32 Optical time}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjfubah}(h]h ]h"]h$]h&]uh1jhjcubj)}(hhh]h)}(hBTime in microseconds from the beginning of a frame till its middleh]hBTime in microseconds from the beginning of a frame till its middle}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahj}ubah}(h]h ]h"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Readout timeh]h__u32 Readout time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h.Time, used to read out a frame in microsecondsh]h.Time, used to read out a frame in microseconds}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Exposure timeh]h__u32 Exposure time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h#Frame exposure time in microsecondsh]h#Frame exposure time in microseconds}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Frame intervalh]h__u32 Frame interval}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhj ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h%In microseconds = 1000000 / framerateh]h%In microseconds = 1000000 / framerate}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Pipe latencyh]h__u32 Pipe latency}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjBubah}(h]h ]h"]h$]h&]uh1jhj?ubj)}(hhh]h)}(h>Time in microseconds from start of frame to data in USB bufferh]h>Time in microseconds from start of frame to data in USB buffer}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjYubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]j)}(hhh]h)}(h:cspan:`1` *Configuration*h](h }(hj|hhhNhNubj)}(h*Configuration*h]h Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1hhhhKjhjyubah}(h]h ]h"]h$]h&]morecolsKuh1jhjvubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 IDh]h__u32 ID}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h 0x80000002h]h 0x80000002}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Sizeh]h __u32 Size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh]h)}(h(Size in bytes, include ID (v1:36, v3:40)h]h(Size in bytes, include ID (v1:36, v3:40)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Versionh]h __u32 Version}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKohj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hVersion of this structure. The documentation herein corresponds to version xxx. The version number will be incremented when new fields are added.h]hVersion of this structure. The documentation herein corresponds to version xxx. The version number will be incremented when new fields are added.}(hj0 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphj- ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Flagsh]h __u32 Flags}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjM ubah}(h]h ]h"]h$]h&]uh1jhjJ ubj)}(hhh]h)}(h"A bitmask of flags: see [4_] belowh](hA bitmask of flags: see [}(hjg hhhNhNubj)}(h4_h]h4}(hjo hhhNhNubah}(h]h ]h"]h$]h&]name4hid4uh1jhjg jKubh] below}(hjg hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKthjd ubah}(h]h ]h"]h$]h&]uh1jhjJ ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u8 Hardware typeh]h__u8 Hardware type}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hCamera hardware version [5_]h](hCamera hardware version [}(hj hhhNhNubj)}(h5_h]h5}(hj hhhNhNubah}(h]h ]h"]h$]h&]name5hid5uh1jhj jKubh]}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKvhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u8 SKU IDh]h __u8 SKU ID}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h"Camera hardware configuration [6_]h](hCamera hardware configuration [}(hj hhhNhNubj)}(h6_h]h6}(hj hhhNhNubah}(h]h ]h"]h$]h&]name6hid6uh1jhj jKubh]}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKxhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u32 Cookieh]h __u32 Cookie}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhj1 ubah}(h]h ]h"]h$]h&]uh1jhj. ubj)}(hhh]h)}(hInternal synchronisationh]hInternal synchronisation}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKzhjH ubah}(h]h ]h"]h$]h&]uh1jhj. ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u16 Formath]h __u16 Format}(hjk hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hjh ubah}(h]h ]h"]h$]h&]uh1jhje ubj)}(hhh]h)}(hImage format code [7_]h](hImage format code [}(hj hhhNhNubj)}(h7_h]h7}(hj hhhNhNubah}(h]h ]h"]h$]h&]name7hid7uh1jhj jKubh]}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK|hj ubah}(h]h ]h"]h$]h&]uh1jhje ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u16 Widthh]h __u16 Width}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hWidth in pixelsh]hWidth in pixels}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u16 Heighth]h __u16 Height}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hHeight in pixelsh]hHeight in pixels}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u16 Framerateh]h__u16 Framerate}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj" ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(hRequested frame rate per secondh]hRequested frame rate per second}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj9 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h __u16 Triggerh]h __u16 Trigger}(hj\ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjY ubah}(h]h ]h"]h$]h&]uh1jhjV ubj)}(hhh]h)}(hFByte 0: bit 0: depth and RGB are synchronised, bit 1: external triggerh]hFByte 0: bit 0: depth and RGB are synchronised, bit 1: external trigger}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjp ubah}(h]h ]h"]h$]h&]uh1jhjV ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h!__u16 Calibration count (v3 only)h]h!__u16 Calibration count (v3 only)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h#Calibration counter, see [4_] belowh](hCalibration counter, see [}(hj hhhNhNubj)}(h4_h]h4}(hj hhhNhNubah}(h]h ]h"]h$]h&]namej~ hj uh1jhj jKubh] below}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u8 GPIO input data (v3 only)h]h__u8 GPIO input data (v3 only)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hhh]h)}(h9GPIO readout, see [4_] below (Supported from FW 5.12.7.0)h](hGPIO readout, see [}(hj hhhNhNubj)}(h4_h]h4}(hj hhhNhNubah}(h]h ]h"]h$]h&]namej~ hj uh1jhj jKubh$] below (Supported from FW 5.12.7.0)}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u32 Sub-preset info (v3 only)h]h__u32 Sub-preset info (v3 only)}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj$ ubah}(h]h ]h"]h$]h&]uh1jhj! ubj)}(hhh]h)}(h-Sub-preset choice information, see [4_] belowh](h$Sub-preset choice information, see [}(hj> hhhNhNubj)}(h4_h]h4}(hjF hhhNhNubah}(h]h ]h"]h$]h&]namej~ hj uh1jhj> jKubh] below}(hj> hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj; ubah}(h]h ]h"]h$]h&]uh1jhj! ubeh}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j)}(hhh]h)}(h__u8 reserved (v3 only)h]h__u8 reserved (v3 only)}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjn ubah}(h]h ]h"]h$]h&]uh1jhjk ubj)}(hhh]h)}(h RFU byte.h]h RFU byte.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhjk ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubeh}(h]id10ah ]h"]h$]h&]uh1j}hhhhhNhNubh)}(h.. _1:h]h}(h]h ]h"]h$]h&]hjuh1hhKhhhhhh referencedKubh)}(hW[1] https://docs.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-extensions-1-5h](h[1] }(hj hhhNhNubj)}(hShttps://docs.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-extensions-1-5h]hShttps://docs.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-extensions-1-5}(hj hhhNhNubah}(h]h ]h"]h$]h&]refurij uh1jhj ubeh}(h]jah ]h"]1ah$]h&]uh1hhhhKhhhhexpect_referenced_by_name}j j sexpect_referenced_by_id}jj sj Kubh)}(h.. _2:h]h}(h]h ]h"]h$]h&]hjuh1hhKhhhhhhj Kubh)}(h:[2] Depth Control flags specify which fields are valid: ::h]h7[2] Depth Control flags specify which fields are valid:}(hj hhhNhNubah}(h]jah ]h"]2ah$]h&]uh1hhhhKhhhhj }j j sj }jj sj Kubh literal_block)}(h0x00000001 Gain 0x00000002 Exposure 0x00000004 Laser power 0x00000008 AE mode 0x00000010 Exposure priority 0x00000020 AE ROI 0x00000040 Preset 0x00000080 Emitter mode 0x00000100 LED Powerh]h0x00000001 Gain 0x00000002 Exposure 0x00000004 Laser power 0x00000008 AE mode 0x00000010 Exposure priority 0x00000020 AE ROI 0x00000040 Preset 0x00000080 Emitter mode 0x00000100 LED Power}hj sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _3:h]h}(h]h ]h"]h$]h&]hjuh1hhKhhhhhhj Kubh)}(h;[3] Capture Timing flags specify which fields are valid: ::h]h8[3] Capture Timing flags specify which fields are valid:}(hj hhhNhNubah}(h]jah ]h"]3ah$]h&]uh1hhhhKhhhhj }j$ j sj }jj sj Kubj )}(h0x00000001 Frame counter 0x00000002 Optical time 0x00000004 Readout time 0x00000008 Exposure time 0x00000010 Frame interval 0x00000020 Pipe latencyh]h0x00000001 Frame counter 0x00000002 Optical time 0x00000004 Readout time 0x00000008 Exposure time 0x00000010 Frame interval 0x00000020 Pipe latency}hj) sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _4:h]h}(h]h ]h"]h$]h&]hj uh1hhKhhhhhhj Kubh)}(h:[4] Configuration flags specify which fields are valid: ::h]h7[4] Configuration flags specify which fields are valid:}(hjA hhhNhNubah}(h]j ah ]h"]4ah$]h&]uh1hhhhKhhhhj }jM j7 sj }j j7 sj Kubj )}(h0x00000001 Hardware type 0x00000002 SKU ID 0x00000004 Cookie 0x00000008 Format 0x00000010 Width 0x00000020 Height 0x00000040 Framerate 0x00000080 Trigger 0x00000100 Cal count 0x00000200 GPIO Input Data 0x00000400 Sub-preset Infoh]h0x00000001 Hardware type 0x00000002 SKU ID 0x00000004 Cookie 0x00000008 Format 0x00000010 Width 0x00000020 Height 0x00000040 Framerate 0x00000080 Trigger 0x00000100 Cal count 0x00000200 GPIO Input Data 0x00000400 Sub-preset Info}hjR sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _5:h]h}(h]h ]h"]h$]h&]hj uh1hhKhhhhhhj Kubh)}(h[5] Camera model: ::h]h[5] Camera model:}(hjj hhhNhNubah}(h]j ah ]h"]5ah$]h&]uh1hhhhKhhhhj }jv j` sj }j j` sj Kubj )}(h0 DS5 1 IVCAM2h]h0 DS5 1 IVCAM2}hj{ sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _6:h]h}(h]h ]h"]h$]h&]hj uh1hhKhhhhhhj Kubh)}(h4[6] 8-bit camera hardware configuration bitfield: ::h]h1[6] 8-bit camera hardware configuration bitfield:}(hj hhhNhNubah}(h]j ah ]h"]6ah$]h&]uh1hhhhKhhhhj }j j sj }j j sj Kubj )}(hX7[1:0] depthCamera 00: no depth 01: standard depth 10: wide depth 11: reserved [2] depthIsActive - has a laser projector [3] RGB presence [4] Inertial Measurement Unit (IMU) presence [5] projectorType 0: HPTG 1: Princeton [6] 0: a projector, 1: an LED [7] reservedh]hX7[1:0] depthCamera 00: no depth 01: standard depth 10: wide depth 11: reserved [2] depthIsActive - has a laser projector [3] RGB presence [4] Inertial Measurement Unit (IMU) presence [5] projectorType 0: HPTG 1: Princeton [6] 0: a projector, 1: an LED [7] reserved}hj sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _7:h]h}(h]h ]h"]h$]h&]hj uh1hhKhhhhhhj Kubh)}(h5[7] Image format codes per video streaming interface:h]h5[7] Image format codes per video streaming interface:}(hj hhhNhNubah}(h]j ah ]h"]7ah$]h&]uh1hhhhKhhhhj }j j sj }j j sj Kubh)}(h Depth: ::h]hDepth:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubj )}(h 1 Z16 2 Zh]h 1 Z16 2 Z}hj sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(hLeft sensor: ::h]h Left sensor:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubj )}(h&1 Y8 2 UYVY 3 R8L8 4 Calibration 5 W10h]h&1 Y8 2 UYVY 3 R8L8 4 Calibration 5 W10}hj sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(hFish Eye sensor: ::h]hFish Eye sensor:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubj )}(h1 RAW8h]h1 RAW8}hjsbah}(h]h ]h"]h$]h&]hhuh1j hhhKhhhhubh)}(h.. _8:h]h}(h]h ]h"]h$]h&]hjpuh1hhKhhhhhhj Kubh)}(hX[8] The "Laser mode" has been replaced in version 3 by three different fields. "Laser" has been renamed to "Emitter" as there are multiple technologies for camera projectors. As we have another field for "Laser Power" we introduced "LED Power" for extra emitter.h]hX[8] The “Laser mode” has been replaced in version 3 by three different fields. “Laser” has been renamed to “Emitter” as there are multiple technologies for camera projectors. As we have another field for “Laser Power” we introduced “LED Power” for extra emitter.}(hj+hhhNhNubah}(h]jpah ]h"]8ah$]h&]uh1hhhhKhhhhj }j7j!sj }jpj!sj Kubhdefinition_list)}(hhh]hdefinition_list_item)}(hlThe "Laser mode" __u32 fields has been split into: :: 1 __u8 Emitter mode 2 __u8 RFU byte 3 __u16 LED Power h](hterm)}(h5The "Laser mode" __u32 fields has been split into: ::h]h9The “Laser mode” __u32 fields has been split into: ::}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jGhhhKhjCubh definition)}(hhh]h)}(h51 __u8 Emitter mode 2 __u8 RFU byte 3 __u16 LED Powerh]h51 __u8 Emitter mode 2 __u8 RFU byte 3 __u16 LED Power}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjYubah}(h]h ]h"]h$]h&]uh1jWhjCubeh}(h]h ]h"]h$]h&]uh1jAhhhKhj>ubah}(h]h ]h"]h$]h&]uh1j<hhhhhhhNubh)}(hThis is a change between versions 1 and 3. All versions 1, 2 and 3 are backward compatible with the same data format and they are supported. See [2_] for which attributes are valid.h](hThis is a change between versions 1 and 3. All versions 1, 2 and 3 are backward compatible with the same data format and they are supported. See [}(hj|hhhNhNubj)}(h2_h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]namejhjuh1jhj|jKubh!] for which attributes are valid.}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h.. _9:h]h}(h]h ]h"]h$]h&]hjWuh1hhKhhhhhhj Kubh)}(ho[9] LibRealSense SDK metadata source: https://github.com/IntelRealSense/librealsense/blob/master/src/metadata.hh](h&[9] LibRealSense SDK metadata source: }(hjhhhNhNubj)}(hIhttps://github.com/IntelRealSense/librealsense/blob/master/src/metadata.hh]hIhttps://github.com/IntelRealSense/librealsense/blob/master/src/metadata.h}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubeh}(h]jWah ]h"]9ah$]h&]uh1hhhhKhhhhj }jjsj }jWjsj Kubeh}(h] descriptionah ]h"] descriptionah$]h&]uh1hhhhhhhhK ubeh}(h](v4l2-meta-fmt-d4xx-d4xxheh ]h"](v4l2_meta_fmt_d4xx ('d4xx')v4l2-meta-fmt-d4xxeh$]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}(1](jje9]jGa2](jje8]j`a3]ja4](jo j j jF e5]j a6]j a7]j aurefids}(h]haj]j aj]j aj]j aj ]j7 aj ]j` aj ]j aj ]j ajp]j!ajW]jaunameids}(jhjjjjj jj jj$ jjM j jv j j j j j j7jpjjWu nametypes}(jjjj j j$ jM jv j j j7juh}(hhjhjhjj jj jj j jA j jj j j j j jpj+jWjj ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j K sRparse_messages]hsystem_message)}(hhh]h)}(h`Blank line missing before literal block (after the "::")? Interpreted as a definition list item.h]hdBlank line missing before literal block (after the “::”)? Interpreted as a definition list item.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|ubah}(h]h ]h"]h$]h&]levelKtypeINFOlineKsourcehuh1jzhjYubatransform_messages]j{)}(hhh]h)}(hhh]h8Hyperlink target "v4l2-meta-fmt-d4xx" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejsourcehlineKuh1jzuba transformerN include_log] decorationNhhub.