xref: /OK3568_Linux_fs/kernel/Documentation/userspace-api/media/v4l/pixfmt-nv16.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun.. _V4L2-PIX-FMT-NV16:
4*4882a593Smuzhiyun.. _V4L2-PIX-FMT-NV61:
5*4882a593Smuzhiyun
6*4882a593Smuzhiyun******************************************************
7*4882a593SmuzhiyunV4L2_PIX_FMT_NV16 ('NV16'), V4L2_PIX_FMT_NV61 ('NV61')
8*4882a593Smuzhiyun******************************************************
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunV4L2_PIX_FMT_NV61
11*4882a593SmuzhiyunFormats with ½ horizontal chroma resolution, also known as YUV 4:2:2.
12*4882a593SmuzhiyunOne luminance and one chrominance plane with alternating chroma samples
13*4882a593Smuzhiyunas opposed to ``V4L2_PIX_FMT_YVU420``
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunDescription
17*4882a593Smuzhiyun===========
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunThese are two-plane versions of the YUV 4:2:2 format. The three
20*4882a593Smuzhiyuncomponents are separated into two sub-images or planes. The Y plane is
21*4882a593Smuzhiyunfirst. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV16``, a
22*4882a593Smuzhiyuncombined CbCr plane immediately follows the Y plane in memory. The CbCr
23*4882a593Smuzhiyunplane is the same width and height, in bytes, as the Y plane (and of the
24*4882a593Smuzhiyunimage). Each CbCr pair belongs to two pixels. For example,
25*4882a593SmuzhiyunCb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`.
26*4882a593Smuzhiyun``V4L2_PIX_FMT_NV61`` is the same except the Cb and Cr bytes are
27*4882a593Smuzhiyunswapped, the CrCb plane starts with a Cr byte.
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunIf the Y plane has pad bytes after each row, then the CbCr plane has as
30*4882a593Smuzhiyunmany pad bytes after its rows.
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun**Byte Order.**
33*4882a593SmuzhiyunEach cell is one byte.
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun
36*4882a593Smuzhiyun.. flat-table::
37*4882a593Smuzhiyun    :header-rows:  0
38*4882a593Smuzhiyun    :stub-columns: 0
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun    * - start + 0:
41*4882a593Smuzhiyun      - Y'\ :sub:`00`
42*4882a593Smuzhiyun      - Y'\ :sub:`01`
43*4882a593Smuzhiyun      - Y'\ :sub:`02`
44*4882a593Smuzhiyun      - Y'\ :sub:`03`
45*4882a593Smuzhiyun    * - start + 4:
46*4882a593Smuzhiyun      - Y'\ :sub:`10`
47*4882a593Smuzhiyun      - Y'\ :sub:`11`
48*4882a593Smuzhiyun      - Y'\ :sub:`12`
49*4882a593Smuzhiyun      - Y'\ :sub:`13`
50*4882a593Smuzhiyun    * - start + 8:
51*4882a593Smuzhiyun      - Y'\ :sub:`20`
52*4882a593Smuzhiyun      - Y'\ :sub:`21`
53*4882a593Smuzhiyun      - Y'\ :sub:`22`
54*4882a593Smuzhiyun      - Y'\ :sub:`23`
55*4882a593Smuzhiyun    * - start + 12:
56*4882a593Smuzhiyun      - Y'\ :sub:`30`
57*4882a593Smuzhiyun      - Y'\ :sub:`31`
58*4882a593Smuzhiyun      - Y'\ :sub:`32`
59*4882a593Smuzhiyun      - Y'\ :sub:`33`
60*4882a593Smuzhiyun    * - start + 16:
61*4882a593Smuzhiyun      - Cb\ :sub:`00`
62*4882a593Smuzhiyun      - Cr\ :sub:`00`
63*4882a593Smuzhiyun      - Cb\ :sub:`01`
64*4882a593Smuzhiyun      - Cr\ :sub:`01`
65*4882a593Smuzhiyun    * - start + 20:
66*4882a593Smuzhiyun      - Cb\ :sub:`10`
67*4882a593Smuzhiyun      - Cr\ :sub:`10`
68*4882a593Smuzhiyun      - Cb\ :sub:`11`
69*4882a593Smuzhiyun      - Cr\ :sub:`11`
70*4882a593Smuzhiyun    * - start + 24:
71*4882a593Smuzhiyun      - Cb\ :sub:`20`
72*4882a593Smuzhiyun      - Cr\ :sub:`20`
73*4882a593Smuzhiyun      - Cb\ :sub:`21`
74*4882a593Smuzhiyun      - Cr\ :sub:`21`
75*4882a593Smuzhiyun    * - start + 28:
76*4882a593Smuzhiyun      - Cb\ :sub:`30`
77*4882a593Smuzhiyun      - Cr\ :sub:`30`
78*4882a593Smuzhiyun      - Cb\ :sub:`31`
79*4882a593Smuzhiyun      - Cr\ :sub:`31`
80*4882a593Smuzhiyun
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun**Color Sample Location:**
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun.. flat-table::
87*4882a593Smuzhiyun    :header-rows:  0
88*4882a593Smuzhiyun    :stub-columns: 0
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun    * -
91*4882a593Smuzhiyun      - 0
92*4882a593Smuzhiyun      -
93*4882a593Smuzhiyun      - 1
94*4882a593Smuzhiyun      - 2
95*4882a593Smuzhiyun      -
96*4882a593Smuzhiyun      - 3
97*4882a593Smuzhiyun    * - 0
98*4882a593Smuzhiyun      - Y
99*4882a593Smuzhiyun      -
100*4882a593Smuzhiyun      - Y
101*4882a593Smuzhiyun      - Y
102*4882a593Smuzhiyun      -
103*4882a593Smuzhiyun      - Y
104*4882a593Smuzhiyun    * -
105*4882a593Smuzhiyun      -
106*4882a593Smuzhiyun      - C
107*4882a593Smuzhiyun      -
108*4882a593Smuzhiyun      -
109*4882a593Smuzhiyun      - C
110*4882a593Smuzhiyun      -
111*4882a593Smuzhiyun    * - 1
112*4882a593Smuzhiyun      - Y
113*4882a593Smuzhiyun      -
114*4882a593Smuzhiyun      - Y
115*4882a593Smuzhiyun      - Y
116*4882a593Smuzhiyun      -
117*4882a593Smuzhiyun      - Y
118*4882a593Smuzhiyun    * -
119*4882a593Smuzhiyun      -
120*4882a593Smuzhiyun      - C
121*4882a593Smuzhiyun      -
122*4882a593Smuzhiyun      -
123*4882a593Smuzhiyun      - C
124*4882a593Smuzhiyun      -
125*4882a593Smuzhiyun    * -
126*4882a593Smuzhiyun    * - 2
127*4882a593Smuzhiyun      - Y
128*4882a593Smuzhiyun      -
129*4882a593Smuzhiyun      - Y
130*4882a593Smuzhiyun      - Y
131*4882a593Smuzhiyun      -
132*4882a593Smuzhiyun      - Y
133*4882a593Smuzhiyun    * -
134*4882a593Smuzhiyun      -
135*4882a593Smuzhiyun      - C
136*4882a593Smuzhiyun      -
137*4882a593Smuzhiyun      -
138*4882a593Smuzhiyun      - C
139*4882a593Smuzhiyun      -
140*4882a593Smuzhiyun    * - 3
141*4882a593Smuzhiyun      - Y
142*4882a593Smuzhiyun      -
143*4882a593Smuzhiyun      - Y
144*4882a593Smuzhiyun      - Y
145*4882a593Smuzhiyun      -
146*4882a593Smuzhiyun      - Y
147*4882a593Smuzhiyun    * -
148*4882a593Smuzhiyun      -
149*4882a593Smuzhiyun      - C
150*4882a593Smuzhiyun      -
151*4882a593Smuzhiyun      -
152*4882a593Smuzhiyun      - C
153*4882a593Smuzhiyun      -
154