xref: /linux/Documentation/userspace-api/media/v4l/pixfmt-cnf4.rst (revision d30c1683aaecb93d2ab95685dc4300a33d3cea7a)
1.. -*- coding: utf-8; mode: rst -*-
2.. c:namespace:: V4L
3
4.. _V4L2-PIX-FMT-CNF4:
5
6******************************
7V4L2_PIX_FMT_CNF4 ('CNF4')
8******************************
9
10Depth sensor confidence information as a 4 bits per pixel packed array
11
12Description
13===========
14
15Proprietary format used by Intel RealSense Depth cameras containing depth
16confidence information in range 0-15 with 0 indicating that the sensor was
17unable to resolve any signal and 15 indicating maximum level of confidence for
18the specific sensor (actual error margins might change from sensor to sensor).
19
20Every two consecutive pixels are packed into a single byte.
21Bits 0-3 of byte n refer to confidence value of depth pixel 2*n,
22bits 4-7 to confidence value of depth pixel 2*n+1.
23
24**Bit-packed representation.**
25
26.. flat-table::
27    :header-rows:  0
28    :stub-columns: 0
29    :widths: 64 64
30
31    * - Y'\ :sub:`01[3:0]`\ (bits 7--4) Y'\ :sub:`00[3:0]`\ (bits 3--0)
32      - Y'\ :sub:`03[3:0]`\ (bits 7--4) Y'\ :sub:`02[3:0]`\ (bits 3--0)
33