Commit | Line | Data |
---|---|---|
5377d91f MH |
1 | .. -*- coding: utf-8; mode: rst -*- |
2 | ||
3 | .. _V4L2-PIX-FMT-NV16M: | |
9aff73d2 | 4 | .. _v4l2-pix-fmt-nv61m: |
5377d91f MH |
5 | |
6 | ******************************************************** | |
7 | V4L2_PIX_FMT_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61') | |
8 | ******************************************************** | |
9 | ||
5377d91f MH |
10 | V4L2_PIX_FMT_NV61M |
11 | Variation of ``V4L2_PIX_FMT_NV16`` and ``V4L2_PIX_FMT_NV61`` with planes | |
12 | non contiguous in memory. | |
13 | ||
14 | ||
15 | Description | |
16 | =========== | |
17 | ||
18 | This is a multi-planar, two-plane version of the YUV 4:2:2 format. The | |
19 | three components are separated into two sub-images or planes. | |
20 | ``V4L2_PIX_FMT_NV16M`` differs from ``V4L2_PIX_FMT_NV16`` in that the | |
21 | two planes are non-contiguous in memory, i.e. the chroma plane does not | |
22 | necessarily immediately follow the luma plane. The luminance data | |
23 | occupies the first plane. The Y plane has one byte per pixel. In the | |
24 | second plane there is chrominance data with alternating chroma samples. | |
25 | The CbCr plane is the same width and height, in bytes, as the Y plane. | |
26 | Each CbCr pair belongs to two pixels. For example, | |
eba9e91c | 27 | Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`. |
5377d91f MH |
28 | ``V4L2_PIX_FMT_NV61M`` is the same as ``V4L2_PIX_FMT_NV16M`` except the |
29 | Cb and Cr bytes are swapped, the CrCb plane starts with a Cr byte. | |
30 | ||
31 | ``V4L2_PIX_FMT_NV16M`` and ``V4L2_PIX_FMT_NV61M`` are intended to be | |
32 | used only in drivers and applications that support the multi-planar API, | |
33 | described in :ref:`planar-apis`. | |
34 | ||
056d2ee6 | 35 | **Byte Order.** |
5377d91f MH |
36 | Each cell is one byte. |
37 | ||
38 | ||
5377d91f MH |
39 | .. flat-table:: |
40 | :header-rows: 0 | |
41 | :stub-columns: 0 | |
5377d91f MH |
42 | |
43 | - .. row 1 | |
44 | ||
45 | - start0 + 0: | |
46 | ||
47 | - Y'\ :sub:`00` | |
48 | ||
49 | - Y'\ :sub:`01` | |
50 | ||
51 | - Y'\ :sub:`02` | |
52 | ||
53 | - Y'\ :sub:`03` | |
54 | ||
55 | - .. row 2 | |
56 | ||
57 | - start0 + 4: | |
58 | ||
59 | - Y'\ :sub:`10` | |
60 | ||
61 | - Y'\ :sub:`11` | |
62 | ||
63 | - Y'\ :sub:`12` | |
64 | ||
65 | - Y'\ :sub:`13` | |
66 | ||
67 | - .. row 3 | |
68 | ||
69 | - start0 + 8: | |
70 | ||
71 | - Y'\ :sub:`20` | |
72 | ||
73 | - Y'\ :sub:`21` | |
74 | ||
75 | - Y'\ :sub:`22` | |
76 | ||
77 | - Y'\ :sub:`23` | |
78 | ||
79 | - .. row 4 | |
80 | ||
81 | - start0 + 12: | |
82 | ||
83 | - Y'\ :sub:`30` | |
84 | ||
85 | - Y'\ :sub:`31` | |
86 | ||
87 | - Y'\ :sub:`32` | |
88 | ||
89 | - Y'\ :sub:`33` | |
90 | ||
91 | - .. row 5 | |
92 | ||
0579e6e3 | 93 | - |
5377d91f MH |
94 | |
95 | - .. row 6 | |
96 | ||
97 | - start1 + 0: | |
98 | ||
99 | - Cb\ :sub:`00` | |
100 | ||
101 | - Cr\ :sub:`00` | |
102 | ||
103 | - Cb\ :sub:`02` | |
104 | ||
105 | - Cr\ :sub:`02` | |
106 | ||
107 | - .. row 7 | |
108 | ||
109 | - start1 + 4: | |
110 | ||
111 | - Cb\ :sub:`10` | |
112 | ||
113 | - Cr\ :sub:`10` | |
114 | ||
115 | - Cb\ :sub:`12` | |
116 | ||
117 | - Cr\ :sub:`12` | |
118 | ||
119 | - .. row 8 | |
120 | ||
121 | - start1 + 8: | |
122 | ||
123 | - Cb\ :sub:`20` | |
124 | ||
125 | - Cr\ :sub:`20` | |
126 | ||
127 | - Cb\ :sub:`22` | |
128 | ||
129 | - Cr\ :sub:`22` | |
130 | ||
131 | - .. row 9 | |
132 | ||
133 | - start1 + 12: | |
134 | ||
135 | - Cb\ :sub:`30` | |
136 | ||
137 | - Cr\ :sub:`30` | |
138 | ||
139 | - Cb\ :sub:`32` | |
140 | ||
141 | - Cr\ :sub:`32` | |
142 | ||
143 | ||
144 | **Color Sample Location..** | |
145 | ||
146 | ||
147 | ||
148 | .. flat-table:: | |
149 | :header-rows: 0 | |
150 | :stub-columns: 0 | |
151 | ||
152 | ||
153 | - .. row 1 | |
154 | ||
0579e6e3 | 155 | - |
5377d91f MH |
156 | - 0 |
157 | ||
0579e6e3 | 158 | - |
5377d91f MH |
159 | - 1 |
160 | ||
5377d91f MH |
161 | - 2 |
162 | ||
0579e6e3 | 163 | - |
5377d91f MH |
164 | - 3 |
165 | ||
166 | - .. row 2 | |
167 | ||
168 | - 0 | |
169 | ||
170 | - Y | |
171 | ||
0579e6e3 | 172 | - |
5377d91f MH |
173 | - Y |
174 | ||
5377d91f MH |
175 | - Y |
176 | ||
0579e6e3 | 177 | - |
5377d91f MH |
178 | - Y |
179 | ||
180 | - .. row 3 | |
181 | ||
0579e6e3 MCC |
182 | - |
183 | - | |
5377d91f MH |
184 | - C |
185 | ||
0579e6e3 MCC |
186 | - |
187 | - | |
5377d91f MH |
188 | - C |
189 | ||
0579e6e3 | 190 | - |
5377d91f MH |
191 | |
192 | - .. row 4 | |
193 | ||
194 | - 1 | |
195 | ||
196 | - Y | |
197 | ||
0579e6e3 | 198 | - |
5377d91f MH |
199 | - Y |
200 | ||
5377d91f MH |
201 | - Y |
202 | ||
0579e6e3 | 203 | - |
5377d91f MH |
204 | - Y |
205 | ||
206 | - .. row 5 | |
207 | ||
0579e6e3 MCC |
208 | - |
209 | - | |
5377d91f MH |
210 | - C |
211 | ||
0579e6e3 MCC |
212 | - |
213 | - | |
5377d91f MH |
214 | - C |
215 | ||
0579e6e3 | 216 | - |
5377d91f MH |
217 | |
218 | - .. row 6 | |
219 | ||
0579e6e3 | 220 | - |
5377d91f MH |
221 | |
222 | - .. row 7 | |
223 | ||
224 | - 2 | |
225 | ||
226 | - Y | |
227 | ||
0579e6e3 | 228 | - |
5377d91f MH |
229 | - Y |
230 | ||
5377d91f MH |
231 | - Y |
232 | ||
0579e6e3 | 233 | - |
5377d91f MH |
234 | - Y |
235 | ||
236 | - .. row 8 | |
237 | ||
0579e6e3 MCC |
238 | - |
239 | - | |
5377d91f MH |
240 | - C |
241 | ||
0579e6e3 MCC |
242 | - |
243 | - | |
5377d91f MH |
244 | - C |
245 | ||
0579e6e3 | 246 | - |
5377d91f MH |
247 | |
248 | - .. row 9 | |
249 | ||
250 | - 3 | |
251 | ||
252 | - Y | |
253 | ||
0579e6e3 | 254 | - |
5377d91f MH |
255 | - Y |
256 | ||
5377d91f MH |
257 | - Y |
258 | ||
0579e6e3 | 259 | - |
5377d91f MH |
260 | - Y |
261 | ||
262 | - .. row 10 | |
263 | ||
0579e6e3 MCC |
264 | - |
265 | - | |
5377d91f MH |
266 | - C |
267 | ||
0579e6e3 MCC |
268 | - |
269 | - | |
5377d91f MH |
270 | - C |
271 | ||
0579e6e3 | 272 | - |