Merge branches 'intel_pstate' and 'pm-domains'
[sfrench/cifs-2.6.git] / Documentation / media / uapi / v4l / pixfmt-inzi.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _V4L2-PIX-FMT-INZI:
4
5 **************************
6 V4L2_PIX_FMT_INZI ('INZI')
7 **************************
8
9 Infrared 10-bit linked with Depth 16-bit images
10
11
12 Description
13 ===========
14
15 Proprietary multi-planar format used by Intel SR300 Depth cameras, comprise of
16 Infrared image followed by Depth data. The pixel definition is 32-bpp,
17 with the Depth and Infrared Data split into separate continuous planes of
18 identical dimensions.
19
20
21
22 The first plane - Infrared data - is stored according to
23 :ref:`V4L2_PIX_FMT_Y10 <V4L2-PIX-FMT-Y10>` greyscale format.
24 Each pixel is 16-bit cell, with actual data stored in the 10 LSBs
25 with values in range 0 to 1023.
26 The six remaining MSBs are padded with zeros.
27
28
29 The 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.**
34 Each cell is a 16-bit word with more significant data stored at higher
35 memory address (byte order is little-endian).
36
37 .. raw:: latex
38
39     \newline\newline\begin{adjustbox}{width=\columnwidth}
40
41 .. tabularcolumns:: |p{4.0cm}|p{4.0cm}|p{4.0cm}|p{4.0cm}|p{4.0cm}|p{4.0cm}|
42
43 .. flat-table::
44     :header-rows:  0
45     :stub-columns: 1
46     :widths:    1 1 1 1 1 1
47
48     * - Ir\ :sub:`0,0`
49       - Ir\ :sub:`0,1`
50       - Ir\ :sub:`0,2`
51       - ...
52       - ...
53       - ...
54     * - :cspan:`5` ...
55     * - :cspan:`5` Infrared Data
56     * - :cspan:`5` ...
57     * - ...
58       - ...
59       - ...
60       - Ir\ :sub:`n-1,n-3`
61       - Ir\ :sub:`n-1,n-2`
62       - Ir\ :sub:`n-1,n-1`
63     * - Depth\ :sub:`0,0`
64       - Depth\ :sub:`0,1`
65       - Depth\ :sub:`0,2`
66       - ...
67       - ...
68       - ...
69     * - :cspan:`5` ...
70     * - :cspan:`5` Depth Data
71     * - :cspan:`5` ...
72     * - ...
73       - ...
74       - ...
75       - Depth\ :sub:`n-1,n-3`
76       - Depth\ :sub:`n-1,n-2`
77       - Depth\ :sub:`n-1,n-1`
78
79 .. raw:: latex
80
81     \end{adjustbox}\newline\newline