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