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