Merge branch 'xen/xenbus' into upstream/xen
[pandora-kernel.git] / Documentation / DocBook / v4l / pixfmt-packed-rgb.xml
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>&nbsp;</entry>
73             <entry spanname="b0">Byte&nbsp;0 in memory</entry>
74             <entry spanname="b1">Byte&nbsp;1</entry>
75             <entry spanname="b2">Byte&nbsp;2</entry>
76             <entry spanname="b3">Byte&nbsp;3</entry>
77           </row>
78           <row>
79             <entry>&nbsp;</entry>
80             <entry>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</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 &times; 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&nbsp;+&nbsp;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&nbsp;+&nbsp;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&nbsp;+&nbsp;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&nbsp;+&nbsp;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>&nbsp;</entry>
533             <entry spanname="b0">Byte&nbsp;0 in memory</entry>
534             <entry spanname="b1">Byte&nbsp;1</entry>
535             <entry spanname="b2">Byte&nbsp;2</entry>
536             <entry spanname="b3">Byte&nbsp;3</entry>
537           </row>
538           <row>
539             <entry>&nbsp;</entry>
540             <entry>&nbsp;</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>&nbsp;</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>&nbsp;</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>&nbsp;</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   -->