xref: /OK3568_Linux_fs/kernel/Documentation/userspace-api/media/v4l/pixfmt-yuv422p.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun.. _V4L2-PIX-FMT-YUV422P:
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun*****************************
6*4882a593SmuzhiyunV4L2_PIX_FMT_YUV422P ('422P')
7*4882a593Smuzhiyun*****************************
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunFormat with ½ horizontal chroma resolution, also known as YUV 4:2:2.
11*4882a593SmuzhiyunPlanar layout as opposed to ``V4L2_PIX_FMT_YUYV``
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun
14*4882a593SmuzhiyunDescription
15*4882a593Smuzhiyun===========
16*4882a593Smuzhiyun
17*4882a593SmuzhiyunThis format is not commonly used. This is a planar version of the YUYV
18*4882a593Smuzhiyunformat. The three components are separated into three sub-images or
19*4882a593Smuzhiyunplanes. The Y plane is first. The Y plane has one byte per pixel. The Cb
20*4882a593Smuzhiyunplane immediately follows the Y plane in memory. The Cb plane is half
21*4882a593Smuzhiyunthe width of the Y plane (and of the image). Each Cb belongs to two
22*4882a593Smuzhiyunpixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
23*4882a593SmuzhiyunY'\ :sub:`01`. Following the Cb plane is the Cr plane, just like the Cb
24*4882a593Smuzhiyunplane.
25*4882a593Smuzhiyun
26*4882a593SmuzhiyunIf the Y plane has pad bytes after each row, then the Cr and Cb planes
27*4882a593Smuzhiyunhave half as many pad bytes after their rows. In other words, two Cx
28*4882a593Smuzhiyunrows (including padding) is exactly as long as one Y row (including
29*4882a593Smuzhiyunpadding).
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun**Byte Order.**
32*4882a593SmuzhiyunEach cell is one byte.
33*4882a593Smuzhiyun
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun.. flat-table::
38*4882a593Smuzhiyun    :header-rows:  0
39*4882a593Smuzhiyun    :stub-columns: 0
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun    * - start + 0:
42*4882a593Smuzhiyun      - Y'\ :sub:`00`
43*4882a593Smuzhiyun      - Y'\ :sub:`01`
44*4882a593Smuzhiyun      - Y'\ :sub:`02`
45*4882a593Smuzhiyun      - Y'\ :sub:`03`
46*4882a593Smuzhiyun    * - start + 4:
47*4882a593Smuzhiyun      - Y'\ :sub:`10`
48*4882a593Smuzhiyun      - Y'\ :sub:`11`
49*4882a593Smuzhiyun      - Y'\ :sub:`12`
50*4882a593Smuzhiyun      - Y'\ :sub:`13`
51*4882a593Smuzhiyun    * - start + 8:
52*4882a593Smuzhiyun      - Y'\ :sub:`20`
53*4882a593Smuzhiyun      - Y'\ :sub:`21`
54*4882a593Smuzhiyun      - Y'\ :sub:`22`
55*4882a593Smuzhiyun      - Y'\ :sub:`23`
56*4882a593Smuzhiyun    * - start + 12:
57*4882a593Smuzhiyun      - Y'\ :sub:`30`
58*4882a593Smuzhiyun      - Y'\ :sub:`31`
59*4882a593Smuzhiyun      - Y'\ :sub:`32`
60*4882a593Smuzhiyun      - Y'\ :sub:`33`
61*4882a593Smuzhiyun    * - start + 16:
62*4882a593Smuzhiyun      - Cb\ :sub:`00`
63*4882a593Smuzhiyun      - Cb\ :sub:`01`
64*4882a593Smuzhiyun    * - start + 18:
65*4882a593Smuzhiyun      - Cb\ :sub:`10`
66*4882a593Smuzhiyun      - Cb\ :sub:`11`
67*4882a593Smuzhiyun    * - start + 20:
68*4882a593Smuzhiyun      - Cb\ :sub:`20`
69*4882a593Smuzhiyun      - Cb\ :sub:`21`
70*4882a593Smuzhiyun    * - start + 22:
71*4882a593Smuzhiyun      - Cb\ :sub:`30`
72*4882a593Smuzhiyun      - Cb\ :sub:`31`
73*4882a593Smuzhiyun    * - start + 24:
74*4882a593Smuzhiyun      - Cr\ :sub:`00`
75*4882a593Smuzhiyun      - Cr\ :sub:`01`
76*4882a593Smuzhiyun    * - start + 26:
77*4882a593Smuzhiyun      - Cr\ :sub:`10`
78*4882a593Smuzhiyun      - Cr\ :sub:`11`
79*4882a593Smuzhiyun    * - start + 28:
80*4882a593Smuzhiyun      - Cr\ :sub:`20`
81*4882a593Smuzhiyun      - Cr\ :sub:`21`
82*4882a593Smuzhiyun    * - start + 30:
83*4882a593Smuzhiyun      - Cr\ :sub:`30`
84*4882a593Smuzhiyun      - Cr\ :sub:`31`
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun
87*4882a593Smuzhiyun**Color Sample Location:**
88*4882a593Smuzhiyun
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun.. flat-table::
92*4882a593Smuzhiyun    :header-rows:  0
93*4882a593Smuzhiyun    :stub-columns: 0
94*4882a593Smuzhiyun
95*4882a593Smuzhiyun    * -
96*4882a593Smuzhiyun      - 0
97*4882a593Smuzhiyun      -
98*4882a593Smuzhiyun      - 1
99*4882a593Smuzhiyun      - 2
100*4882a593Smuzhiyun      -
101*4882a593Smuzhiyun      - 3
102*4882a593Smuzhiyun    * - 0
103*4882a593Smuzhiyun      - Y
104*4882a593Smuzhiyun      - C
105*4882a593Smuzhiyun      - Y
106*4882a593Smuzhiyun      - Y
107*4882a593Smuzhiyun      - C
108*4882a593Smuzhiyun      - Y
109*4882a593Smuzhiyun    * - 1
110*4882a593Smuzhiyun      - Y
111*4882a593Smuzhiyun      - C
112*4882a593Smuzhiyun      - Y
113*4882a593Smuzhiyun      - Y
114*4882a593Smuzhiyun      - C
115*4882a593Smuzhiyun      - Y
116*4882a593Smuzhiyun    * - 2
117*4882a593Smuzhiyun      - Y
118*4882a593Smuzhiyun      - C
119*4882a593Smuzhiyun      - Y
120*4882a593Smuzhiyun      - Y
121*4882a593Smuzhiyun      - C
122*4882a593Smuzhiyun      - Y
123*4882a593Smuzhiyun    * - 3
124*4882a593Smuzhiyun      - Y
125*4882a593Smuzhiyun      - C
126*4882a593Smuzhiyun      - Y
127*4882a593Smuzhiyun      - Y
128*4882a593Smuzhiyun      - C
129*4882a593Smuzhiyun      - Y
130