xref: /linux/Documentation/userspace-api/media/v4l/pixfmt-inzi.rst (revision 778b8ebe5192e7a7f00563a7456517dfa63e1d90)
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: V4L
3
4.. _V4L2-PIX-FMT-INZI:
5
6**************************
7V4L2_PIX_FMT_INZI ('INZI')
8**************************
9
10Infrared 10-bit linked with Depth 16-bit images
11
12
13Description
14===========
15
16Proprietary multi-planar format used by Intel SR300 Depth cameras, comprise of
17Infrared image followed by Depth data. The pixel definition is 32-bpp,
18with the Depth and Infrared Data split into separate continuous planes of
19identical dimensions.
20
21
22
23The first plane - Infrared data - is stored according to
24:ref:`V4L2_PIX_FMT_Y10 <V4L2-PIX-FMT-Y10>` greyscale format.
25Each pixel is 16-bit cell, with actual data stored in the 10 LSBs
26with values in range 0 to 1023.
27The six remaining MSBs are padded with zeros.
28
29
30The second plane provides 16-bit per-pixel Depth data arranged in
31:ref:`V4L2-PIX-FMT-Z16 <V4L2-PIX-FMT-Z16>` format.
32
33
34**Frame Structure.**
35Each cell is a 16-bit word with more significant data stored at higher
36memory address (byte order is little-endian).
37
38
39.. raw:: latex
40
41    \small
42
43.. tabularcolumns:: |p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|
44
45.. flat-table::
46    :header-rows:  0
47    :stub-columns: 1
48    :widths:    1 1 1 1 1 1
49
50    * - Ir\ :sub:`0,0`
51      - Ir\ :sub:`0,1`
52      - Ir\ :sub:`0,2`
53      - ...
54      - ...
55      - ...
56    * - :cspan:`5` ...
57    * - :cspan:`5` Infrared Data
58    * - :cspan:`5` ...
59    * - ...
60      - ...
61      - ...
62      - Ir\ :sub:`n-1,n-3`
63      - Ir\ :sub:`n-1,n-2`
64      - Ir\ :sub:`n-1,n-1`
65    * - Depth\ :sub:`0,0`
66      - Depth\ :sub:`0,1`
67      - Depth\ :sub:`0,2`
68      - ...
69      - ...
70      - ...
71    * - :cspan:`5` ...
72    * - :cspan:`5` Depth Data
73    * - :cspan:`5` ...
74    * - ...
75      - ...
76      - ...
77      - Depth\ :sub:`n-1,n-3`
78      - Depth\ :sub:`n-1,n-2`
79      - Depth\ :sub:`n-1,n-1`
80
81.. raw:: latex
82
83    \normalsize
84