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