Documentation/userspace-api/media/v4l/pixfmt-inzi.rst

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   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
  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