diff options
Diffstat (limited to 'Documentation/DocBook/v4l/pixfmt-packed-rgb.xml')
-rw-r--r-- | Documentation/DocBook/v4l/pixfmt-packed-rgb.xml | 862 |
1 files changed, 862 insertions, 0 deletions
diff --git a/Documentation/DocBook/v4l/pixfmt-packed-rgb.xml b/Documentation/DocBook/v4l/pixfmt-packed-rgb.xml new file mode 100644 index 000000000000..d2dd697a81d8 --- /dev/null +++ b/Documentation/DocBook/v4l/pixfmt-packed-rgb.xml | |||
@@ -0,0 +1,862 @@ | |||
1 | <refentry id="packed-rgb"> | ||
2 | <refmeta> | ||
3 | <refentrytitle>Packed RGB formats</refentrytitle> | ||
4 | &manvol; | ||
5 | </refmeta> | ||
6 | <refnamediv> | ||
7 | <refname>Packed RGB formats</refname> | ||
8 | <refpurpose>Packed RGB formats</refpurpose> | ||
9 | </refnamediv> | ||
10 | <refsect1> | ||
11 | <title>Description</title> | ||
12 | |||
13 | <para>These formats are designed to match the pixel formats of | ||
14 | typical PC graphics frame buffers. They occupy 8, 16, 24 or 32 bits | ||
15 | per pixel. These are all packed-pixel formats, meaning all the data | ||
16 | for a pixel lie next to each other in memory.</para> | ||
17 | |||
18 | <para>When one of these formats is used, drivers shall report the | ||
19 | colorspace <constant>V4L2_COLORSPACE_SRGB</constant>.</para> | ||
20 | |||
21 | <table pgwide="1" frame="none" id="rgb-formats"> | ||
22 | <title>Packed RGB Image Formats</title> | ||
23 | <tgroup cols="37" align="center"> | ||
24 | <colspec colname="id" align="left" /> | ||
25 | <colspec colname="fourcc" /> | ||
26 | <colspec colname="bit" /> | ||
27 | |||
28 | <colspec colnum="4" colname="b07" align="center" /> | ||
29 | <colspec colnum="5" colname="b06" align="center" /> | ||
30 | <colspec colnum="6" colname="b05" align="center" /> | ||
31 | <colspec colnum="7" colname="b04" align="center" /> | ||
32 | <colspec colnum="8" colname="b03" align="center" /> | ||
33 | <colspec colnum="9" colname="b02" align="center" /> | ||
34 | <colspec colnum="10" colname="b01" align="center" /> | ||
35 | <colspec colnum="11" colname="b00" align="center" /> | ||
36 | |||
37 | <colspec colnum="13" colname="b17" align="center" /> | ||
38 | <colspec colnum="14" colname="b16" align="center" /> | ||
39 | <colspec colnum="15" colname="b15" align="center" /> | ||
40 | <colspec colnum="16" colname="b14" align="center" /> | ||
41 | <colspec colnum="17" colname="b13" align="center" /> | ||
42 | <colspec colnum="18" colname="b12" align="center" /> | ||
43 | <colspec colnum="19" colname="b11" align="center" /> | ||
44 | <colspec colnum="20" colname="b10" align="center" /> | ||
45 | |||
46 | <colspec colnum="22" colname="b27" align="center" /> | ||
47 | <colspec colnum="23" colname="b26" align="center" /> | ||
48 | <colspec colnum="24" colname="b25" align="center" /> | ||
49 | <colspec colnum="25" colname="b24" align="center" /> | ||
50 | <colspec colnum="26" colname="b23" align="center" /> | ||
51 | <colspec colnum="27" colname="b22" align="center" /> | ||
52 | <colspec colnum="28" colname="b21" align="center" /> | ||
53 | <colspec colnum="29" colname="b20" align="center" /> | ||
54 | |||
55 | <colspec colnum="31" colname="b37" align="center" /> | ||
56 | <colspec colnum="32" colname="b36" align="center" /> | ||
57 | <colspec colnum="33" colname="b35" align="center" /> | ||
58 | <colspec colnum="34" colname="b34" align="center" /> | ||
59 | <colspec colnum="35" colname="b33" align="center" /> | ||
60 | <colspec colnum="36" colname="b32" align="center" /> | ||
61 | <colspec colnum="37" colname="b31" align="center" /> | ||
62 | <colspec colnum="38" colname="b30" align="center" /> | ||
63 | |||
64 | <spanspec namest="b07" nameend="b00" spanname="b0" /> | ||
65 | <spanspec namest="b17" nameend="b10" spanname="b1" /> | ||
66 | <spanspec namest="b27" nameend="b20" spanname="b2" /> | ||
67 | <spanspec namest="b37" nameend="b30" spanname="b3" /> | ||
68 | <thead> | ||
69 | <row> | ||
70 | <entry>Identifier</entry> | ||
71 | <entry>Code</entry> | ||
72 | <entry> </entry> | ||
73 | <entry spanname="b0">Byte 0 in memory</entry> | ||
74 | <entry spanname="b1">Byte 1</entry> | ||
75 | <entry spanname="b2">Byte 2</entry> | ||
76 | <entry spanname="b3">Byte 3</entry> | ||
77 | </row> | ||
78 | <row> | ||
79 | <entry> </entry> | ||
80 | <entry> </entry> | ||
81 | <entry>Bit</entry> | ||
82 | <entry>7</entry> | ||
83 | <entry>6</entry> | ||
84 | <entry>5</entry> | ||
85 | <entry>4</entry> | ||
86 | <entry>3</entry> | ||
87 | <entry>2</entry> | ||
88 | <entry>1</entry> | ||
89 | <entry>0</entry> | ||
90 | <entry> </entry> | ||
91 | <entry>7</entry> | ||
92 | <entry>6</entry> | ||
93 | <entry>5</entry> | ||
94 | <entry>4</entry> | ||
95 | <entry>3</entry> | ||
96 | <entry>2</entry> | ||
97 | <entry>1</entry> | ||
98 | <entry>0</entry> | ||
99 | <entry> </entry> | ||
100 | <entry>7</entry> | ||
101 | <entry>6</entry> | ||
102 | <entry>5</entry> | ||
103 | <entry>4</entry> | ||
104 | <entry>3</entry> | ||
105 | <entry>2</entry> | ||
106 | <entry>1</entry> | ||
107 | <entry>0</entry> | ||
108 | <entry> </entry> | ||
109 | <entry>7</entry> | ||
110 | <entry>6</entry> | ||
111 | <entry>5</entry> | ||
112 | <entry>4</entry> | ||
113 | <entry>3</entry> | ||
114 | <entry>2</entry> | ||
115 | <entry>1</entry> | ||
116 | <entry>0</entry> | ||
117 | </row> | ||
118 | </thead> | ||
119 | <tbody valign="top"> | ||
120 | <row id="V4L2-PIX-FMT-RGB332"> | ||
121 | <entry><constant>V4L2_PIX_FMT_RGB332</constant></entry> | ||
122 | <entry>'RGB1'</entry> | ||
123 | <entry></entry> | ||
124 | <entry>b<subscript>1</subscript></entry> | ||
125 | <entry>b<subscript>0</subscript></entry> | ||
126 | <entry>g<subscript>2</subscript></entry> | ||
127 | <entry>g<subscript>1</subscript></entry> | ||
128 | <entry>g<subscript>0</subscript></entry> | ||
129 | <entry>r<subscript>2</subscript></entry> | ||
130 | <entry>r<subscript>1</subscript></entry> | ||
131 | <entry>r<subscript>0</subscript></entry> | ||
132 | </row> | ||
133 | <row id="V4L2-PIX-FMT-RGB444"> | ||
134 | <entry><constant>V4L2_PIX_FMT_RGB444</constant></entry> | ||
135 | <entry>'R444'</entry> | ||
136 | <entry></entry> | ||
137 | <entry>g<subscript>3</subscript></entry> | ||
138 | <entry>g<subscript>2</subscript></entry> | ||
139 | <entry>g<subscript>1</subscript></entry> | ||
140 | <entry>g<subscript>0</subscript></entry> | ||
141 | <entry>b<subscript>3</subscript></entry> | ||
142 | <entry>b<subscript>2</subscript></entry> | ||
143 | <entry>b<subscript>1</subscript></entry> | ||
144 | <entry>b<subscript>0</subscript></entry> | ||
145 | <entry></entry> | ||
146 | <entry>a<subscript>3</subscript></entry> | ||
147 | <entry>a<subscript>2</subscript></entry> | ||
148 | <entry>a<subscript>1</subscript></entry> | ||
149 | <entry>a<subscript>0</subscript></entry> | ||
150 | <entry>r<subscript>3</subscript></entry> | ||
151 | <entry>r<subscript>2</subscript></entry> | ||
152 | <entry>r<subscript>1</subscript></entry> | ||
153 | <entry>r<subscript>0</subscript></entry> | ||
154 | </row> | ||
155 | <row id="V4L2-PIX-FMT-RGB555"> | ||
156 | <entry><constant>V4L2_PIX_FMT_RGB555</constant></entry> | ||
157 | <entry>'RGBO'</entry> | ||
158 | <entry></entry> | ||
159 | <entry>g<subscript>2</subscript></entry> | ||
160 | <entry>g<subscript>1</subscript></entry> | ||
161 | <entry>g<subscript>0</subscript></entry> | ||
162 | <entry>r<subscript>4</subscript></entry> | ||
163 | <entry>r<subscript>3</subscript></entry> | ||
164 | <entry>r<subscript>2</subscript></entry> | ||
165 | <entry>r<subscript>1</subscript></entry> | ||
166 | <entry>r<subscript>0</subscript></entry> | ||
167 | <entry></entry> | ||
168 | <entry>a</entry> | ||
169 | <entry>b<subscript>4</subscript></entry> | ||
170 | <entry>b<subscript>3</subscript></entry> | ||
171 | <entry>b<subscript>2</subscript></entry> | ||
172 | <entry>b<subscript>1</subscript></entry> | ||
173 | <entry>b<subscript>0</subscript></entry> | ||
174 | <entry>g<subscript>4</subscript></entry> | ||
175 | <entry>g<subscript>3</subscript></entry> | ||
176 | </row> | ||
177 | <row id="V4L2-PIX-FMT-RGB565"> | ||
178 | <entry><constant>V4L2_PIX_FMT_RGB565</constant></entry> | ||
179 | <entry>'RGBP'</entry> | ||
180 | <entry></entry> | ||
181 | <entry>g<subscript>2</subscript></entry> | ||
182 | <entry>g<subscript>1</subscript></entry> | ||
183 | <entry>g<subscript>0</subscript></entry> | ||
184 | <entry>r<subscript>4</subscript></entry> | ||
185 | <entry>r<subscript>3</subscript></entry> | ||
186 | <entry>r<subscript>2</subscript></entry> | ||
187 | <entry>r<subscript>1</subscript></entry> | ||
188 | <entry>r<subscript>0</subscript></entry> | ||
189 | <entry></entry> | ||
190 | <entry>b<subscript>4</subscript></entry> | ||
191 | <entry>b<subscript>3</subscript></entry> | ||
192 | <entry>b<subscript>2</subscript></entry> | ||
193 | <entry>b<subscript>1</subscript></entry> | ||
194 | <entry>b<subscript>0</subscript></entry> | ||
195 | <entry>g<subscript>5</subscript></entry> | ||
196 | <entry>g<subscript>4</subscript></entry> | ||
197 | <entry>g<subscript>3</subscript></entry> | ||
198 | </row> | ||
199 | <row id="V4L2-PIX-FMT-RGB555X"> | ||
200 | <entry><constant>V4L2_PIX_FMT_RGB555X</constant></entry> | ||
201 | <entry>'RGBQ'</entry> | ||
202 | <entry></entry> | ||
203 | <entry>a</entry> | ||
204 | <entry>b<subscript>4</subscript></entry> | ||
205 | <entry>b<subscript>3</subscript></entry> | ||
206 | <entry>b<subscript>2</subscript></entry> | ||
207 | <entry>b<subscript>1</subscript></entry> | ||
208 | <entry>b<subscript>0</subscript></entry> | ||
209 | <entry>g<subscript>4</subscript></entry> | ||
210 | <entry>g<subscript>3</subscript></entry> | ||
211 | <entry></entry> | ||
212 | <entry>g<subscript>2</subscript></entry> | ||
213 | <entry>g<subscript>1</subscript></entry> | ||
214 | <entry>g<subscript>0</subscript></entry> | ||
215 | <entry>r<subscript>4</subscript></entry> | ||
216 | <entry>r<subscript>3</subscript></entry> | ||
217 | <entry>r<subscript>2</subscript></entry> | ||
218 | <entry>r<subscript>1</subscript></entry> | ||
219 | <entry>r<subscript>0</subscript></entry> | ||
220 | </row> | ||
221 | <row id="V4L2-PIX-FMT-RGB565X"> | ||
222 | <entry><constant>V4L2_PIX_FMT_RGB565X</constant></entry> | ||
223 | <entry>'RGBR'</entry> | ||
224 | <entry></entry> | ||
225 | <entry>b<subscript>4</subscript></entry> | ||
226 | <entry>b<subscript>3</subscript></entry> | ||
227 | <entry>b<subscript>2</subscript></entry> | ||
228 | <entry>b<subscript>1</subscript></entry> | ||
229 | <entry>b<subscript>0</subscript></entry> | ||
230 | <entry>g<subscript>5</subscript></entry> | ||
231 | <entry>g<subscript>4</subscript></entry> | ||
232 | <entry>g<subscript>3</subscript></entry> | ||
233 | <entry></entry> | ||
234 | <entry>g<subscript>2</subscript></entry> | ||
235 | <entry>g<subscript>1</subscript></entry> | ||
236 | <entry>g<subscript>0</subscript></entry> | ||
237 | <entry>r<subscript>4</subscript></entry> | ||
238 | <entry>r<subscript>3</subscript></entry> | ||
239 | <entry>r<subscript>2</subscript></entry> | ||
240 | <entry>r<subscript>1</subscript></entry> | ||
241 | <entry>r<subscript>0</subscript></entry> | ||
242 | </row> | ||
243 | <row id="V4L2-PIX-FMT-BGR24"> | ||
244 | <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry> | ||
245 | <entry>'BGR3'</entry> | ||
246 | <entry></entry> | ||
247 | <entry>b<subscript>7</subscript></entry> | ||
248 | <entry>b<subscript>6</subscript></entry> | ||
249 | <entry>b<subscript>5</subscript></entry> | ||
250 | <entry>b<subscript>4</subscript></entry> | ||
251 | <entry>b<subscript>3</subscript></entry> | ||
252 | <entry>b<subscript>2</subscript></entry> | ||
253 | <entry>b<subscript>1</subscript></entry> | ||
254 | <entry>b<subscript>0</subscript></entry> | ||
255 | <entry></entry> | ||
256 | <entry>g<subscript>7</subscript></entry> | ||
257 | <entry>g<subscript>6</subscript></entry> | ||
258 | <entry>g<subscript>5</subscript></entry> | ||
259 | <entry>g<subscript>4</subscript></entry> | ||
260 | <entry>g<subscript>3</subscript></entry> | ||
261 | <entry>g<subscript>2</subscript></entry> | ||
262 | <entry>g<subscript>1</subscript></entry> | ||
263 | <entry>g<subscript>0</subscript></entry> | ||
264 | <entry></entry> | ||
265 | <entry>r<subscript>7</subscript></entry> | ||
266 | <entry>r<subscript>6</subscript></entry> | ||
267 | <entry>r<subscript>5</subscript></entry> | ||
268 | <entry>r<subscript>4</subscript></entry> | ||
269 | <entry>r<subscript>3</subscript></entry> | ||
270 | <entry>r<subscript>2</subscript></entry> | ||
271 | <entry>r<subscript>1</subscript></entry> | ||
272 | <entry>r<subscript>0</subscript></entry> | ||
273 | </row> | ||
274 | <row id="V4L2-PIX-FMT-RGB24"> | ||
275 | <entry><constant>V4L2_PIX_FMT_RGB24</constant></entry> | ||
276 | <entry>'RGB3'</entry> | ||
277 | <entry></entry> | ||
278 | <entry>r<subscript>7</subscript></entry> | ||
279 | <entry>r<subscript>6</subscript></entry> | ||
280 | <entry>r<subscript>5</subscript></entry> | ||
281 | <entry>r<subscript>4</subscript></entry> | ||
282 | <entry>r<subscript>3</subscript></entry> | ||
283 | <entry>r<subscript>2</subscript></entry> | ||
284 | <entry>r<subscript>1</subscript></entry> | ||
285 | <entry>r<subscript>0</subscript></entry> | ||
286 | <entry></entry> | ||
287 | <entry>g<subscript>7</subscript></entry> | ||
288 | <entry>g<subscript>6</subscript></entry> | ||
289 | <entry>g<subscript>5</subscript></entry> | ||
290 | <entry>g<subscript>4</subscript></entry> | ||
291 | <entry>g<subscript>3</subscript></entry> | ||
292 | <entry>g<subscript>2</subscript></entry> | ||
293 | <entry>g<subscript>1</subscript></entry> | ||
294 | <entry>g<subscript>0</subscript></entry> | ||
295 | <entry></entry> | ||
296 | <entry>b<subscript>7</subscript></entry> | ||
297 | <entry>b<subscript>6</subscript></entry> | ||
298 | <entry>b<subscript>5</subscript></entry> | ||
299 | <entry>b<subscript>4</subscript></entry> | ||
300 | <entry>b<subscript>3</subscript></entry> | ||
301 | <entry>b<subscript>2</subscript></entry> | ||
302 | <entry>b<subscript>1</subscript></entry> | ||
303 | <entry>b<subscript>0</subscript></entry> | ||
304 | </row> | ||
305 | <row id="V4L2-PIX-FMT-BGR32"> | ||
306 | <entry><constant>V4L2_PIX_FMT_BGR32</constant></entry> | ||
307 | <entry>'BGR4'</entry> | ||
308 | <entry></entry> | ||
309 | <entry>b<subscript>7</subscript></entry> | ||
310 | <entry>b<subscript>6</subscript></entry> | ||
311 | <entry>b<subscript>5</subscript></entry> | ||
312 | <entry>b<subscript>4</subscript></entry> | ||
313 | <entry>b<subscript>3</subscript></entry> | ||
314 | <entry>b<subscript>2</subscript></entry> | ||
315 | <entry>b<subscript>1</subscript></entry> | ||
316 | <entry>b<subscript>0</subscript></entry> | ||
317 | <entry></entry> | ||
318 | <entry>g<subscript>7</subscript></entry> | ||
319 | <entry>g<subscript>6</subscript></entry> | ||
320 | <entry>g<subscript>5</subscript></entry> | ||
321 | <entry>g<subscript>4</subscript></entry> | ||
322 | <entry>g<subscript>3</subscript></entry> | ||
323 | <entry>g<subscript>2</subscript></entry> | ||
324 | <entry>g<subscript>1</subscript></entry> | ||
325 | <entry>g<subscript>0</subscript></entry> | ||
326 | <entry></entry> | ||
327 | <entry>r<subscript>7</subscript></entry> | ||
328 | <entry>r<subscript>6</subscript></entry> | ||
329 | <entry>r<subscript>5</subscript></entry> | ||
330 | <entry>r<subscript>4</subscript></entry> | ||
331 | <entry>r<subscript>3</subscript></entry> | ||
332 | <entry>r<subscript>2</subscript></entry> | ||
333 | <entry>r<subscript>1</subscript></entry> | ||
334 | <entry>r<subscript>0</subscript></entry> | ||
335 | <entry></entry> | ||
336 | <entry>a<subscript>7</subscript></entry> | ||
337 | <entry>a<subscript>6</subscript></entry> | ||
338 | <entry>a<subscript>5</subscript></entry> | ||
339 | <entry>a<subscript>4</subscript></entry> | ||
340 | <entry>a<subscript>3</subscript></entry> | ||
341 | <entry>a<subscript>2</subscript></entry> | ||
342 | <entry>a<subscript>1</subscript></entry> | ||
343 | <entry>a<subscript>0</subscript></entry> | ||
344 | </row> | ||
345 | <row id="V4L2-PIX-FMT-RGB32"> | ||
346 | <entry><constant>V4L2_PIX_FMT_RGB32</constant></entry> | ||
347 | <entry>'RGB4'</entry> | ||
348 | <entry></entry> | ||
349 | <entry>r<subscript>7</subscript></entry> | ||
350 | <entry>r<subscript>6</subscript></entry> | ||
351 | <entry>r<subscript>5</subscript></entry> | ||
352 | <entry>r<subscript>4</subscript></entry> | ||
353 | <entry>r<subscript>3</subscript></entry> | ||
354 | <entry>r<subscript>2</subscript></entry> | ||
355 | <entry>r<subscript>1</subscript></entry> | ||
356 | <entry>r<subscript>0</subscript></entry> | ||
357 | <entry></entry> | ||
358 | <entry>g<subscript>7</subscript></entry> | ||
359 | <entry>g<subscript>6</subscript></entry> | ||
360 | <entry>g<subscript>5</subscript></entry> | ||
361 | <entry>g<subscript>4</subscript></entry> | ||
362 | <entry>g<subscript>3</subscript></entry> | ||
363 | <entry>g<subscript>2</subscript></entry> | ||
364 | <entry>g<subscript>1</subscript></entry> | ||
365 | <entry>g<subscript>0</subscript></entry> | ||
366 | <entry></entry> | ||
367 | <entry>b<subscript>7</subscript></entry> | ||
368 | <entry>b<subscript>6</subscript></entry> | ||
369 | <entry>b<subscript>5</subscript></entry> | ||
370 | <entry>b<subscript>4</subscript></entry> | ||
371 | <entry>b<subscript>3</subscript></entry> | ||
372 | <entry>b<subscript>2</subscript></entry> | ||
373 | <entry>b<subscript>1</subscript></entry> | ||
374 | <entry>b<subscript>0</subscript></entry> | ||
375 | <entry></entry> | ||
376 | <entry>a<subscript>7</subscript></entry> | ||
377 | <entry>a<subscript>6</subscript></entry> | ||
378 | <entry>a<subscript>5</subscript></entry> | ||
379 | <entry>a<subscript>4</subscript></entry> | ||
380 | <entry>a<subscript>3</subscript></entry> | ||
381 | <entry>a<subscript>2</subscript></entry> | ||
382 | <entry>a<subscript>1</subscript></entry> | ||
383 | <entry>a<subscript>0</subscript></entry> | ||
384 | </row> | ||
385 | </tbody> | ||
386 | </tgroup> | ||
387 | </table> | ||
388 | |||
389 | <para>Bit 7 is the most significant bit. The value of a = alpha | ||
390 | bits is undefined when reading from the driver, ignored when writing | ||
391 | to the driver, except when alpha blending has been negotiated for a | ||
392 | <link linkend="overlay">Video Overlay</link> or <link | ||
393 | linkend="osd">Video Output Overlay</link>.</para> | ||
394 | |||
395 | <example> | ||
396 | <title><constant>V4L2_PIX_FMT_BGR24</constant> 4 × 4 pixel | ||
397 | image</title> | ||
398 | |||
399 | <formalpara> | ||
400 | <title>Byte Order.</title> | ||
401 | <para>Each cell is one byte. | ||
402 | <informaltable frame="none"> | ||
403 | <tgroup cols="13" align="center"> | ||
404 | <colspec align="left" colwidth="2*" /> | ||
405 | <tbody valign="top"> | ||
406 | <row> | ||
407 | <entry>start + 0:</entry> | ||
408 | <entry>B<subscript>00</subscript></entry> | ||
409 | <entry>G<subscript>00</subscript></entry> | ||
410 | <entry>R<subscript>00</subscript></entry> | ||
411 | <entry>B<subscript>01</subscript></entry> | ||
412 | <entry>G<subscript>01</subscript></entry> | ||
413 | <entry>R<subscript>01</subscript></entry> | ||
414 | <entry>B<subscript>02</subscript></entry> | ||
415 | <entry>G<subscript>02</subscript></entry> | ||
416 | <entry>R<subscript>02</subscript></entry> | ||
417 | <entry>B<subscript>03</subscript></entry> | ||
418 | <entry>G<subscript>03</subscript></entry> | ||
419 | <entry>R<subscript>03</subscript></entry> | ||
420 | </row> | ||
421 | <row> | ||
422 | <entry>start + 12:</entry> | ||
423 | <entry>B<subscript>10</subscript></entry> | ||
424 | <entry>G<subscript>10</subscript></entry> | ||
425 | <entry>R<subscript>10</subscript></entry> | ||
426 | <entry>B<subscript>11</subscript></entry> | ||
427 | <entry>G<subscript>11</subscript></entry> | ||
428 | <entry>R<subscript>11</subscript></entry> | ||
429 | <entry>B<subscript>12</subscript></entry> | ||
430 | <entry>G<subscript>12</subscript></entry> | ||
431 | <entry>R<subscript>12</subscript></entry> | ||
432 | <entry>B<subscript>13</subscript></entry> | ||
433 | <entry>G<subscript>13</subscript></entry> | ||
434 | <entry>R<subscript>13</subscript></entry> | ||
435 | </row> | ||
436 | <row> | ||
437 | <entry>start + 24:</entry> | ||
438 | <entry>B<subscript>20</subscript></entry> | ||
439 | <entry>G<subscript>20</subscript></entry> | ||
440 | <entry>R<subscript>20</subscript></entry> | ||
441 | <entry>B<subscript>21</subscript></entry> | ||
442 | <entry>G<subscript>21</subscript></entry> | ||
443 | <entry>R<subscript>21</subscript></entry> | ||
444 | <entry>B<subscript>22</subscript></entry> | ||
445 | <entry>G<subscript>22</subscript></entry> | ||
446 | <entry>R<subscript>22</subscript></entry> | ||
447 | <entry>B<subscript>23</subscript></entry> | ||
448 | <entry>G<subscript>23</subscript></entry> | ||
449 | <entry>R<subscript>23</subscript></entry> | ||
450 | </row> | ||
451 | <row> | ||
452 | <entry>start + 36:</entry> | ||
453 | <entry>B<subscript>30</subscript></entry> | ||
454 | <entry>G<subscript>30</subscript></entry> | ||
455 | <entry>R<subscript>30</subscript></entry> | ||
456 | <entry>B<subscript>31</subscript></entry> | ||
457 | <entry>G<subscript>31</subscript></entry> | ||
458 | <entry>R<subscript>31</subscript></entry> | ||
459 | <entry>B<subscript>32</subscript></entry> | ||
460 | <entry>G<subscript>32</subscript></entry> | ||
461 | <entry>R<subscript>32</subscript></entry> | ||
462 | <entry>B<subscript>33</subscript></entry> | ||
463 | <entry>G<subscript>33</subscript></entry> | ||
464 | <entry>R<subscript>33</subscript></entry> | ||
465 | </row> | ||
466 | </tbody> | ||
467 | </tgroup> | ||
468 | </informaltable> | ||
469 | </para> | ||
470 | </formalpara> | ||
471 | </example> | ||
472 | |||
473 | <important> | ||
474 | <para>Drivers may interpret these formats differently.</para> | ||
475 | </important> | ||
476 | |||
477 | <para>Some RGB formats above are uncommon and were probably | ||
478 | defined in error. Drivers may interpret them as in <xref | ||
479 | linkend="rgb-formats-corrected" />.</para> | ||
480 | |||
481 | <table pgwide="1" frame="none" id="rgb-formats-corrected"> | ||
482 | <title>Packed RGB Image Formats (corrected)</title> | ||
483 | <tgroup cols="37" align="center"> | ||
484 | <colspec colname="id" align="left" /> | ||
485 | <colspec colname="fourcc" /> | ||
486 | <colspec colname="bit" /> | ||
487 | |||
488 | <colspec colnum="4" colname="b07" align="center" /> | ||
489 | <colspec colnum="5" colname="b06" align="center" /> | ||
490 | <colspec colnum="6" colname="b05" align="center" /> | ||
491 | <colspec colnum="7" colname="b04" align="center" /> | ||
492 | <colspec colnum="8" colname="b03" align="center" /> | ||
493 | <colspec colnum="9" colname="b02" align="center" /> | ||
494 | <colspec colnum="10" colname="b01" align="center" /> | ||
495 | <colspec colnum="11" colname="b00" align="center" /> | ||
496 | |||
497 | <colspec colnum="13" colname="b17" align="center" /> | ||
498 | <colspec colnum="14" colname="b16" align="center" /> | ||
499 | <colspec colnum="15" colname="b15" align="center" /> | ||
500 | <colspec colnum="16" colname="b14" align="center" /> | ||
501 | <colspec colnum="17" colname="b13" align="center" /> | ||
502 | <colspec colnum="18" colname="b12" align="center" /> | ||
503 | <colspec colnum="19" colname="b11" align="center" /> | ||
504 | <colspec colnum="20" colname="b10" align="center" /> | ||
505 | |||
506 | <colspec colnum="22" colname="b27" align="center" /> | ||
507 | <colspec colnum="23" colname="b26" align="center" /> | ||
508 | <colspec colnum="24" colname="b25" align="center" /> | ||
509 | <colspec colnum="25" colname="b24" align="center" /> | ||
510 | <colspec colnum="26" colname="b23" align="center" /> | ||
511 | <colspec colnum="27" colname="b22" align="center" /> | ||
512 | <colspec colnum="28" colname="b21" align="center" /> | ||
513 | <colspec colnum="29" colname="b20" align="center" /> | ||
514 | |||
515 | <colspec colnum="31" colname="b37" align="center" /> | ||
516 | <colspec colnum="32" colname="b36" align="center" /> | ||
517 | <colspec colnum="33" colname="b35" align="center" /> | ||
518 | <colspec colnum="34" colname="b34" align="center" /> | ||
519 | <colspec colnum="35" colname="b33" align="center" /> | ||
520 | <colspec colnum="36" colname="b32" align="center" /> | ||
521 | <colspec colnum="37" colname="b31" align="center" /> | ||
522 | <colspec colnum="38" colname="b30" align="center" /> | ||
523 | |||
524 | <spanspec namest="b07" nameend="b00" spanname="b0" /> | ||
525 | <spanspec namest="b17" nameend="b10" spanname="b1" /> | ||
526 | <spanspec namest="b27" nameend="b20" spanname="b2" /> | ||
527 | <spanspec namest="b37" nameend="b30" spanname="b3" /> | ||
528 | <thead> | ||
529 | <row> | ||
530 | <entry>Identifier</entry> | ||
531 | <entry>Code</entry> | ||
532 | <entry> </entry> | ||
533 | <entry spanname="b0">Byte 0 in memory</entry> | ||
534 | <entry spanname="b1">Byte 1</entry> | ||
535 | <entry spanname="b2">Byte 2</entry> | ||
536 | <entry spanname="b3">Byte 3</entry> | ||
537 | </row> | ||
538 | <row> | ||
539 | <entry> </entry> | ||
540 | <entry> </entry> | ||
541 | <entry>Bit</entry> | ||
542 | <entry>7</entry> | ||
543 | <entry>6</entry> | ||
544 | <entry>5</entry> | ||
545 | <entry>4</entry> | ||
546 | <entry>3</entry> | ||
547 | <entry>2</entry> | ||
548 | <entry>1</entry> | ||
549 | <entry>0</entry> | ||
550 | <entry> </entry> | ||
551 | <entry>7</entry> | ||
552 | <entry>6</entry> | ||
553 | <entry>5</entry> | ||
554 | <entry>4</entry> | ||
555 | <entry>3</entry> | ||
556 | <entry>2</entry> | ||
557 | <entry>1</entry> | ||
558 | <entry>0</entry> | ||
559 | <entry> </entry> | ||
560 | <entry>7</entry> | ||
561 | <entry>6</entry> | ||
562 | <entry>5</entry> | ||
563 | <entry>4</entry> | ||
564 | <entry>3</entry> | ||
565 | <entry>2</entry> | ||
566 | <entry>1</entry> | ||
567 | <entry>0</entry> | ||
568 | <entry> </entry> | ||
569 | <entry>7</entry> | ||
570 | <entry>6</entry> | ||
571 | <entry>5</entry> | ||
572 | <entry>4</entry> | ||
573 | <entry>3</entry> | ||
574 | <entry>2</entry> | ||
575 | <entry>1</entry> | ||
576 | <entry>0</entry> | ||
577 | </row> | ||
578 | </thead> | ||
579 | <tbody valign="top"> | ||
580 | <row><!-- id="V4L2-PIX-FMT-RGB332" --> | ||
581 | <entry><constant>V4L2_PIX_FMT_RGB332</constant></entry> | ||
582 | <entry>'RGB1'</entry> | ||
583 | <entry></entry> | ||
584 | <entry>r<subscript>2</subscript></entry> | ||
585 | <entry>r<subscript>1</subscript></entry> | ||
586 | <entry>r<subscript>0</subscript></entry> | ||
587 | <entry>g<subscript>2</subscript></entry> | ||
588 | <entry>g<subscript>1</subscript></entry> | ||
589 | <entry>g<subscript>0</subscript></entry> | ||
590 | <entry>b<subscript>1</subscript></entry> | ||
591 | <entry>b<subscript>0</subscript></entry> | ||
592 | </row> | ||
593 | <row><!-- id="V4L2-PIX-FMT-RGB444" --> | ||
594 | <entry><constant>V4L2_PIX_FMT_RGB444</constant></entry> | ||
595 | <entry>'R444'</entry> | ||
596 | <entry></entry> | ||
597 | <entry>g<subscript>3</subscript></entry> | ||
598 | <entry>g<subscript>2</subscript></entry> | ||
599 | <entry>g<subscript>1</subscript></entry> | ||
600 | <entry>g<subscript>0</subscript></entry> | ||
601 | <entry>b<subscript>3</subscript></entry> | ||
602 | <entry>b<subscript>2</subscript></entry> | ||
603 | <entry>b<subscript>1</subscript></entry> | ||
604 | <entry>b<subscript>0</subscript></entry> | ||
605 | <entry></entry> | ||
606 | <entry>a<subscript>3</subscript></entry> | ||
607 | <entry>a<subscript>2</subscript></entry> | ||
608 | <entry>a<subscript>1</subscript></entry> | ||
609 | <entry>a<subscript>0</subscript></entry> | ||
610 | <entry>r<subscript>3</subscript></entry> | ||
611 | <entry>r<subscript>2</subscript></entry> | ||
612 | <entry>r<subscript>1</subscript></entry> | ||
613 | <entry>r<subscript>0</subscript></entry> | ||
614 | </row> | ||
615 | <row><!-- id="V4L2-PIX-FMT-RGB555" --> | ||
616 | <entry><constant>V4L2_PIX_FMT_RGB555</constant></entry> | ||
617 | <entry>'RGBO'</entry> | ||
618 | <entry></entry> | ||
619 | <entry>g<subscript>2</subscript></entry> | ||
620 | <entry>g<subscript>1</subscript></entry> | ||
621 | <entry>g<subscript>0</subscript></entry> | ||
622 | <entry>b<subscript>4</subscript></entry> | ||
623 | <entry>b<subscript>3</subscript></entry> | ||
624 | <entry>b<subscript>2</subscript></entry> | ||
625 | <entry>b<subscript>1</subscript></entry> | ||
626 | <entry>b<subscript>0</subscript></entry> | ||
627 | <entry></entry> | ||
628 | <entry>a</entry> | ||
629 | <entry>r<subscript>4</subscript></entry> | ||
630 | <entry>r<subscript>3</subscript></entry> | ||
631 | <entry>r<subscript>2</subscript></entry> | ||
632 | <entry>r<subscript>1</subscript></entry> | ||
633 | <entry>r<subscript>0</subscript></entry> | ||
634 | <entry>g<subscript>4</subscript></entry> | ||
635 | <entry>g<subscript>3</subscript></entry> | ||
636 | </row> | ||
637 | <row><!-- id="V4L2-PIX-FMT-RGB565" --> | ||
638 | <entry><constant>V4L2_PIX_FMT_RGB565</constant></entry> | ||
639 | <entry>'RGBP'</entry> | ||
640 | <entry></entry> | ||
641 | <entry>g<subscript>2</subscript></entry> | ||
642 | <entry>g<subscript>1</subscript></entry> | ||
643 | <entry>g<subscript>0</subscript></entry> | ||
644 | <entry>b<subscript>4</subscript></entry> | ||
645 | <entry>b<subscript>3</subscript></entry> | ||
646 | <entry>b<subscript>2</subscript></entry> | ||
647 | <entry>b<subscript>1</subscript></entry> | ||
648 | <entry>b<subscript>0</subscript></entry> | ||
649 | <entry></entry> | ||
650 | <entry>r<subscript>4</subscript></entry> | ||
651 | <entry>r<subscript>3</subscript></entry> | ||
652 | <entry>r<subscript>2</subscript></entry> | ||
653 | <entry>r<subscript>1</subscript></entry> | ||
654 | <entry>r<subscript>0</subscript></entry> | ||
655 | <entry>g<subscript>5</subscript></entry> | ||
656 | <entry>g<subscript>4</subscript></entry> | ||
657 | <entry>g<subscript>3</subscript></entry> | ||
658 | </row> | ||
659 | <row><!-- id="V4L2-PIX-FMT-RGB555X" --> | ||
660 | <entry><constant>V4L2_PIX_FMT_RGB555X</constant></entry> | ||
661 | <entry>'RGBQ'</entry> | ||
662 | <entry></entry> | ||
663 | <entry>a</entry> | ||
664 | <entry>r<subscript>4</subscript></entry> | ||
665 | <entry>r<subscript>3</subscript></entry> | ||
666 | <entry>r<subscript>2</subscript></entry> | ||
667 | <entry>r<subscript>1</subscript></entry> | ||
668 | <entry>r<subscript>0</subscript></entry> | ||
669 | <entry>g<subscript>4</subscript></entry> | ||
670 | <entry>g<subscript>3</subscript></entry> | ||
671 | <entry></entry> | ||
672 | <entry>g<subscript>2</subscript></entry> | ||
673 | <entry>g<subscript>1</subscript></entry> | ||
674 | <entry>g<subscript>0</subscript></entry> | ||
675 | <entry>b<subscript>4</subscript></entry> | ||
676 | <entry>b<subscript>3</subscript></entry> | ||
677 | <entry>b<subscript>2</subscript></entry> | ||
678 | <entry>b<subscript>1</subscript></entry> | ||
679 | <entry>b<subscript>0</subscript></entry> | ||
680 | </row> | ||
681 | <row><!-- id="V4L2-PIX-FMT-RGB565X" --> | ||
682 | <entry><constant>V4L2_PIX_FMT_RGB565X</constant></entry> | ||
683 | <entry>'RGBR'</entry> | ||
684 | <entry></entry> | ||
685 | <entry>r<subscript>4</subscript></entry> | ||
686 | <entry>r<subscript>3</subscript></entry> | ||
687 | <entry>r<subscript>2</subscript></entry> | ||
688 | <entry>r<subscript>1</subscript></entry> | ||
689 | <entry>r<subscript>0</subscript></entry> | ||
690 | <entry>g<subscript>5</subscript></entry> | ||
691 | <entry>g<subscript>4</subscript></entry> | ||
692 | <entry>g<subscript>3</subscript></entry> | ||
693 | <entry></entry> | ||
694 | <entry>g<subscript>2</subscript></entry> | ||
695 | <entry>g<subscript>1</subscript></entry> | ||
696 | <entry>g<subscript>0</subscript></entry> | ||
697 | <entry>b<subscript>4</subscript></entry> | ||
698 | <entry>b<subscript>3</subscript></entry> | ||
699 | <entry>b<subscript>2</subscript></entry> | ||
700 | <entry>b<subscript>1</subscript></entry> | ||
701 | <entry>b<subscript>0</subscript></entry> | ||
702 | </row> | ||
703 | <row><!-- id="V4L2-PIX-FMT-BGR24" --> | ||
704 | <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry> | ||
705 | <entry>'BGR3'</entry> | ||
706 | <entry></entry> | ||
707 | <entry>b<subscript>7</subscript></entry> | ||
708 | <entry>b<subscript>6</subscript></entry> | ||
709 | <entry>b<subscript>5</subscript></entry> | ||
710 | <entry>b<subscript>4</subscript></entry> | ||
711 | <entry>b<subscript>3</subscript></entry> | ||
712 | <entry>b<subscript>2</subscript></entry> | ||
713 | <entry>b<subscript>1</subscript></entry> | ||
714 | <entry>b<subscript>0</subscript></entry> | ||
715 | <entry></entry> | ||
716 | <entry>g<subscript>7</subscript></entry> | ||
717 | <entry>g<subscript>6</subscript></entry> | ||
718 | <entry>g<subscript>5</subscript></entry> | ||
719 | <entry>g<subscript>4</subscript></entry> | ||
720 | <entry>g<subscript>3</subscript></entry> | ||
721 | <entry>g<subscript>2</subscript></entry> | ||
722 | <entry>g<subscript>1</subscript></entry> | ||
723 | <entry>g<subscript>0</subscript></entry> | ||
724 | <entry></entry> | ||
725 | <entry>r<subscript>7</subscript></entry> | ||
726 | <entry>r<subscript>6</subscript></entry> | ||
727 | <entry>r<subscript>5</subscript></entry> | ||
728 | <entry>r<subscript>4</subscript></entry> | ||
729 | <entry>r<subscript>3</subscript></entry> | ||
730 | <entry>r<subscript>2</subscript></entry> | ||
731 | <entry>r<subscript>1</subscript></entry> | ||
732 | <entry>r<subscript>0</subscript></entry> | ||
733 | </row> | ||
734 | <row><!-- id="V4L2-PIX-FMT-RGB24" --> | ||
735 | <entry><constant>V4L2_PIX_FMT_RGB24</constant></entry> | ||
736 | <entry>'RGB3'</entry> | ||
737 | <entry></entry> | ||
738 | <entry>r<subscript>7</subscript></entry> | ||
739 | <entry>r<subscript>6</subscript></entry> | ||
740 | <entry>r<subscript>5</subscript></entry> | ||
741 | <entry>r<subscript>4</subscript></entry> | ||
742 | <entry>r<subscript>3</subscript></entry> | ||
743 | <entry>r<subscript>2</subscript></entry> | ||
744 | <entry>r<subscript>1</subscript></entry> | ||
745 | <entry>r<subscript>0</subscript></entry> | ||
746 | <entry></entry> | ||
747 | <entry>g<subscript>7</subscript></entry> | ||
748 | <entry>g<subscript>6</subscript></entry> | ||
749 | <entry>g<subscript>5</subscript></entry> | ||
750 | <entry>g<subscript>4</subscript></entry> | ||
751 | <entry>g<subscript>3</subscript></entry> | ||
752 | <entry>g<subscript>2</subscript></entry> | ||
753 | <entry>g<subscript>1</subscript></entry> | ||
754 | <entry>g<subscript>0</subscript></entry> | ||
755 | <entry></entry> | ||
756 | <entry>b<subscript>7</subscript></entry> | ||
757 | <entry>b<subscript>6</subscript></entry> | ||
758 | <entry>b<subscript>5</subscript></entry> | ||
759 | <entry>b<subscript>4</subscript></entry> | ||
760 | <entry>b<subscript>3</subscript></entry> | ||
761 | <entry>b<subscript>2</subscript></entry> | ||
762 | <entry>b<subscript>1</subscript></entry> | ||
763 | <entry>b<subscript>0</subscript></entry> | ||
764 | </row> | ||
765 | <row><!-- id="V4L2-PIX-FMT-BGR32" --> | ||
766 | <entry><constant>V4L2_PIX_FMT_BGR32</constant></entry> | ||
767 | <entry>'BGR4'</entry> | ||
768 | <entry></entry> | ||
769 | <entry>b<subscript>7</subscript></entry> | ||
770 | <entry>b<subscript>6</subscript></entry> | ||
771 | <entry>b<subscript>5</subscript></entry> | ||
772 | <entry>b<subscript>4</subscript></entry> | ||
773 | <entry>b<subscript>3</subscript></entry> | ||
774 | <entry>b<subscript>2</subscript></entry> | ||
775 | <entry>b<subscript>1</subscript></entry> | ||
776 | <entry>b<subscript>0</subscript></entry> | ||
777 | <entry></entry> | ||
778 | <entry>g<subscript>7</subscript></entry> | ||
779 | <entry>g<subscript>6</subscript></entry> | ||
780 | <entry>g<subscript>5</subscript></entry> | ||
781 | <entry>g<subscript>4</subscript></entry> | ||
782 | <entry>g<subscript>3</subscript></entry> | ||
783 | <entry>g<subscript>2</subscript></entry> | ||
784 | <entry>g<subscript>1</subscript></entry> | ||
785 | <entry>g<subscript>0</subscript></entry> | ||
786 | <entry></entry> | ||
787 | <entry>r<subscript>7</subscript></entry> | ||
788 | <entry>r<subscript>6</subscript></entry> | ||
789 | <entry>r<subscript>5</subscript></entry> | ||
790 | <entry>r<subscript>4</subscript></entry> | ||
791 | <entry>r<subscript>3</subscript></entry> | ||
792 | <entry>r<subscript>2</subscript></entry> | ||
793 | <entry>r<subscript>1</subscript></entry> | ||
794 | <entry>r<subscript>0</subscript></entry> | ||
795 | <entry></entry> | ||
796 | <entry>a<subscript>7</subscript></entry> | ||
797 | <entry>a<subscript>6</subscript></entry> | ||
798 | <entry>a<subscript>5</subscript></entry> | ||
799 | <entry>a<subscript>4</subscript></entry> | ||
800 | <entry>a<subscript>3</subscript></entry> | ||
801 | <entry>a<subscript>2</subscript></entry> | ||
802 | <entry>a<subscript>1</subscript></entry> | ||
803 | <entry>a<subscript>0</subscript></entry> | ||
804 | </row> | ||
805 | <row><!-- id="V4L2-PIX-FMT-RGB32" --> | ||
806 | <entry><constant>V4L2_PIX_FMT_RGB32</constant></entry> | ||
807 | <entry>'RGB4'</entry> | ||
808 | <entry></entry> | ||
809 | <entry>a<subscript>7</subscript></entry> | ||
810 | <entry>a<subscript>6</subscript></entry> | ||
811 | <entry>a<subscript>5</subscript></entry> | ||
812 | <entry>a<subscript>4</subscript></entry> | ||
813 | <entry>a<subscript>3</subscript></entry> | ||
814 | <entry>a<subscript>2</subscript></entry> | ||
815 | <entry>a<subscript>1</subscript></entry> | ||
816 | <entry>a<subscript>0</subscript></entry> | ||
817 | <entry></entry> | ||
818 | <entry>r<subscript>7</subscript></entry> | ||
819 | <entry>r<subscript>6</subscript></entry> | ||
820 | <entry>r<subscript>5</subscript></entry> | ||
821 | <entry>r<subscript>4</subscript></entry> | ||
822 | <entry>r<subscript>3</subscript></entry> | ||
823 | <entry>r<subscript>2</subscript></entry> | ||
824 | <entry>r<subscript>1</subscript></entry> | ||
825 | <entry>r<subscript>0</subscript></entry> | ||
826 | <entry></entry> | ||
827 | <entry>g<subscript>7</subscript></entry> | ||
828 | <entry>g<subscript>6</subscript></entry> | ||
829 | <entry>g<subscript>5</subscript></entry> | ||
830 | <entry>g<subscript>4</subscript></entry> | ||
831 | <entry>g<subscript>3</subscript></entry> | ||
832 | <entry>g<subscript>2</subscript></entry> | ||
833 | <entry>g<subscript>1</subscript></entry> | ||
834 | <entry>g<subscript>0</subscript></entry> | ||
835 | <entry></entry> | ||
836 | <entry>b<subscript>7</subscript></entry> | ||
837 | <entry>b<subscript>6</subscript></entry> | ||
838 | <entry>b<subscript>5</subscript></entry> | ||
839 | <entry>b<subscript>4</subscript></entry> | ||
840 | <entry>b<subscript>3</subscript></entry> | ||
841 | <entry>b<subscript>2</subscript></entry> | ||
842 | <entry>b<subscript>1</subscript></entry> | ||
843 | <entry>b<subscript>0</subscript></entry> | ||
844 | </row> | ||
845 | </tbody> | ||
846 | </tgroup> | ||
847 | </table> | ||
848 | |||
849 | <para>A test utility to determine which RGB formats a driver | ||
850 | actually supports is available from the LinuxTV v4l-dvb repository. | ||
851 | See &v4l-dvb; for access instructions.</para> | ||
852 | |||
853 | </refsect1> | ||
854 | </refentry> | ||
855 | |||
856 | <!-- | ||
857 | Local Variables: | ||
858 | mode: sgml | ||
859 | sgml-parent-document: "pixfmt.sgml" | ||
860 | indent-tabs-mode: nil | ||
861 | End: | ||
862 | --> | ||