Merge remote-tracking branch 'lightnvm/for-next'
[deliverable/linux.git] / Documentation / media / uapi / v4l / pixfmt-nv16m.rst
CommitLineData
5377d91f
MH
1.. -*- coding: utf-8; mode: rst -*-
2
3.. _V4L2-PIX-FMT-NV16M:
9aff73d2 4.. _v4l2-pix-fmt-nv61m:
5377d91f
MH
5
6********************************************************
7V4L2_PIX_FMT_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61')
8********************************************************
9
5377d91f
MH
10V4L2_PIX_FMT_NV61M
11Variation of ``V4L2_PIX_FMT_NV16`` and ``V4L2_PIX_FMT_NV61`` with planes
12non contiguous in memory.
13
14
15Description
16===========
17
18This is a multi-planar, two-plane version of the YUV 4:2:2 format. The
19three components are separated into two sub-images or planes.
20``V4L2_PIX_FMT_NV16M`` differs from ``V4L2_PIX_FMT_NV16`` in that the
21two planes are non-contiguous in memory, i.e. the chroma plane does not
22necessarily immediately follow the luma plane. The luminance data
23occupies the first plane. The Y plane has one byte per pixel. In the
24second plane there is chrominance data with alternating chroma samples.
25The CbCr plane is the same width and height, in bytes, as the Y plane.
26Each CbCr pair belongs to two pixels. For example,
eba9e91c 27Cb\ :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
29Cb 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
32used only in drivers and applications that support the multi-planar API,
33described in :ref:`planar-apis`.
34
056d2ee6 35**Byte Order.**
5377d91f
MH
36Each 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 -
This page took 0.055645 seconds and 5 git commands to generate.