Documentation/media/uapi/v4l/pixfmt-inzi.rst

   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/media/uapi/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 **************************
  13 V4L2_PIX_FMT_INZI ('INZI')
  14 **************************
  15
  16 Infrared 10-bit linked with Depth 16-bit images
  17
  18
  19 Description
  20 ===========
  21
  22 Proprietary multi-planar format used by Intel SR300 Depth cameras, comprise of
  23 Infrared image followed by Depth data. The pixel definition is 32-bpp,
  24 with the Depth and Infrared Data split into separate continuous planes of
  25 identical dimensions.
  26
  27
  28
  29 The first plane - Infrared data - is stored according to
  30 :ref:`V4L2_PIX_FMT_Y10 <V4L2-PIX-FMT-Y10>` greyscale format.
  31 Each pixel is 16-bit cell, with actual data stored in the 10 LSBs
  32 with values in range 0 to 1023.
  33 The six remaining MSBs are padded with zeros.
  34
  35
  36 The 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.**
  41 Each cell is a 16-bit word with more significant data stored at higher
  42 memory 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