xref: /OK3568_Linux_fs/kernel/Documentation/userspace-api/media/v4l/pixfmt-y41p.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981) 
1*4882a593Smuzhiyun.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun.. _V4L2-PIX-FMT-Y41P:
4*4882a593Smuzhiyun
5*4882a593Smuzhiyun**************************
6*4882a593SmuzhiyunV4L2_PIX_FMT_Y41P ('Y41P')
7*4882a593Smuzhiyun**************************
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunFormat with ¼ horizontal chroma resolution, also known as YUV 4:1:1
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun
13*4882a593SmuzhiyunDescription
14*4882a593Smuzhiyun===========
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunIn this format each 12 bytes is eight pixels. In the twelve bytes are
17*4882a593Smuzhiyuntwo CbCr pairs and eight Y's. The first CbCr pair goes with the first
18*4882a593Smuzhiyunfour Y's, and the second CbCr pair goes with the other four Y's. The Cb
19*4882a593Smuzhiyunand Cr components have one fourth the horizontal resolution of the Y
20*4882a593Smuzhiyuncomponent.
21*4882a593Smuzhiyun
22*4882a593SmuzhiyunDo not confuse this format with
23*4882a593Smuzhiyun:ref:`V4L2_PIX_FMT_YUV411P <V4L2-PIX-FMT-YUV411P>`. Y41P is derived
24*4882a593Smuzhiyunfrom "YUV 4:1:1 *packed*", while YUV411P stands for "YUV 4:1:1
25*4882a593Smuzhiyun*planar*".
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun**Byte Order.**
28*4882a593SmuzhiyunEach cell is one byte.
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun
32*4882a593Smuzhiyun
33*4882a593Smuzhiyun.. flat-table::
34*4882a593Smuzhiyun    :header-rows:  0
35*4882a593Smuzhiyun    :stub-columns: 0
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun    * - start + 0:
38*4882a593Smuzhiyun      - Cb\ :sub:`00`
39*4882a593Smuzhiyun      - Y'\ :sub:`00`
40*4882a593Smuzhiyun      - Cr\ :sub:`00`
41*4882a593Smuzhiyun      - Y'\ :sub:`01`
42*4882a593Smuzhiyun      - Cb\ :sub:`01`
43*4882a593Smuzhiyun      - Y'\ :sub:`02`
44*4882a593Smuzhiyun      - Cr\ :sub:`01`
45*4882a593Smuzhiyun      - Y'\ :sub:`03`
46*4882a593Smuzhiyun      - Y'\ :sub:`04`
47*4882a593Smuzhiyun      - Y'\ :sub:`05`
48*4882a593Smuzhiyun      - Y'\ :sub:`06`
49*4882a593Smuzhiyun      - Y'\ :sub:`07`
50*4882a593Smuzhiyun    * - start + 12:
51*4882a593Smuzhiyun      - Cb\ :sub:`10`
52*4882a593Smuzhiyun      - Y'\ :sub:`10`
53*4882a593Smuzhiyun      - Cr\ :sub:`10`
54*4882a593Smuzhiyun      - Y'\ :sub:`11`
55*4882a593Smuzhiyun      - Cb\ :sub:`11`
56*4882a593Smuzhiyun      - Y'\ :sub:`12`
57*4882a593Smuzhiyun      - Cr\ :sub:`11`
58*4882a593Smuzhiyun      - Y'\ :sub:`13`
59*4882a593Smuzhiyun      - Y'\ :sub:`14`
60*4882a593Smuzhiyun      - Y'\ :sub:`15`
61*4882a593Smuzhiyun      - Y'\ :sub:`16`
62*4882a593Smuzhiyun      - Y'\ :sub:`17`
63*4882a593Smuzhiyun    * - start + 24:
64*4882a593Smuzhiyun      - Cb\ :sub:`20`
65*4882a593Smuzhiyun      - Y'\ :sub:`20`
66*4882a593Smuzhiyun      - Cr\ :sub:`20`
67*4882a593Smuzhiyun      - Y'\ :sub:`21`
68*4882a593Smuzhiyun      - Cb\ :sub:`21`
69*4882a593Smuzhiyun      - Y'\ :sub:`22`
70*4882a593Smuzhiyun      - Cr\ :sub:`21`
71*4882a593Smuzhiyun      - Y'\ :sub:`23`
72*4882a593Smuzhiyun      - Y'\ :sub:`24`
73*4882a593Smuzhiyun      - Y'\ :sub:`25`
74*4882a593Smuzhiyun      - Y'\ :sub:`26`
75*4882a593Smuzhiyun      - Y'\ :sub:`27`
76*4882a593Smuzhiyun    * - start + 36:
77*4882a593Smuzhiyun      - Cb\ :sub:`30`
78*4882a593Smuzhiyun      - Y'\ :sub:`30`
79*4882a593Smuzhiyun      - Cr\ :sub:`30`
80*4882a593Smuzhiyun      - Y'\ :sub:`31`
81*4882a593Smuzhiyun      - Cb\ :sub:`31`
82*4882a593Smuzhiyun      - Y'\ :sub:`32`
83*4882a593Smuzhiyun      - Cr\ :sub:`31`
84*4882a593Smuzhiyun      - Y'\ :sub:`33`
85*4882a593Smuzhiyun      - Y'\ :sub:`34`
86*4882a593Smuzhiyun      - Y'\ :sub:`35`
87*4882a593Smuzhiyun      - Y'\ :sub:`36`
88*4882a593Smuzhiyun      - Y'\ :sub:`37`
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun**Color Sample Location:**
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun.. flat-table::
94*4882a593Smuzhiyun    :header-rows:  0
95*4882a593Smuzhiyun    :stub-columns: 0
96*4882a593Smuzhiyun
97*4882a593Smuzhiyun    * -
98*4882a593Smuzhiyun      - 0
99*4882a593Smuzhiyun      - 1
100*4882a593Smuzhiyun      -
101*4882a593Smuzhiyun      - 2
102*4882a593Smuzhiyun      - 3
103*4882a593Smuzhiyun      - 4
104*4882a593Smuzhiyun      - 5
105*4882a593Smuzhiyun      -
106*4882a593Smuzhiyun      - 6
107*4882a593Smuzhiyun      - 7
108*4882a593Smuzhiyun    * - 0
109*4882a593Smuzhiyun      - Y
110*4882a593Smuzhiyun      - Y
111*4882a593Smuzhiyun      - C
112*4882a593Smuzhiyun      - Y
113*4882a593Smuzhiyun      - Y
114*4882a593Smuzhiyun      - Y
115*4882a593Smuzhiyun      - Y
116*4882a593Smuzhiyun      - C
117*4882a593Smuzhiyun      - Y
118*4882a593Smuzhiyun      - Y
119*4882a593Smuzhiyun    * - 1
120*4882a593Smuzhiyun      - Y
121*4882a593Smuzhiyun      - Y
122*4882a593Smuzhiyun      - C
123*4882a593Smuzhiyun      - Y
124*4882a593Smuzhiyun      - Y
125*4882a593Smuzhiyun      - Y
126*4882a593Smuzhiyun      - Y
127*4882a593Smuzhiyun      - C
128*4882a593Smuzhiyun      - Y
129*4882a593Smuzhiyun      - Y
130*4882a593Smuzhiyun    * - 2
131*4882a593Smuzhiyun      - Y
132*4882a593Smuzhiyun      - Y
133*4882a593Smuzhiyun      - C
134*4882a593Smuzhiyun      - Y
135*4882a593Smuzhiyun      - Y
136*4882a593Smuzhiyun      - Y
137*4882a593Smuzhiyun      - Y
138*4882a593Smuzhiyun      - C
139*4882a593Smuzhiyun      - Y
140*4882a593Smuzhiyun      - Y
141*4882a593Smuzhiyun    * - 3
142*4882a593Smuzhiyun      - Y
143*4882a593Smuzhiyun      - Y
144*4882a593Smuzhiyun      - C
145*4882a593Smuzhiyun      - Y
146*4882a593Smuzhiyun      - Y
147*4882a593Smuzhiyun      - Y
148*4882a593Smuzhiyun      - Y
149*4882a593Smuzhiyun      - C
150*4882a593Smuzhiyun      - Y
151*4882a593Smuzhiyun      - Y
152