Commit | Line | Data |
---|---|---|
5377d91f MH |
1 | .. -*- coding: utf-8; mode: rst -*- |
2 | ||
3 | .. _packed-rgb: | |
4 | ||
5 | ****************** | |
6 | Packed RGB formats | |
7 | ****************** | |
8 | ||
9 | *man Packed RGB formats(2)* | |
10 | ||
11 | Packed RGB formats | |
12 | ||
13 | ||
14 | Description | |
15 | =========== | |
16 | ||
17 | These formats are designed to match the pixel formats of typical PC | |
18 | graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel. | |
19 | These are all packed-pixel formats, meaning all the data for a pixel lie | |
20 | next to each other in memory. | |
21 | ||
22 | ||
23 | .. _rgb-formats: | |
24 | ||
25 | .. flat-table:: Packed RGB Image Formats | |
26 | :header-rows: 2 | |
27 | :stub-columns: 0 | |
28 | ||
29 | ||
30 | - .. row 1 | |
31 | ||
32 | - Identifier | |
33 | ||
34 | - Code | |
35 | ||
0579e6e3 | 36 | - |
5377d91f MH |
37 | - :cspan:`7` Byte 0 in memory |
38 | ||
39 | - :cspan:`7` Byte 1 | |
40 | ||
41 | - :cspan:`7` Byte 2 | |
42 | ||
43 | - :cspan:`7` Byte 3 | |
44 | ||
45 | - .. row 2 | |
46 | ||
0579e6e3 MCC |
47 | - |
48 | - | |
5377d91f MH |
49 | - Bit |
50 | ||
51 | - 7 | |
52 | ||
53 | - 6 | |
54 | ||
55 | - 5 | |
56 | ||
57 | - 4 | |
58 | ||
59 | - 3 | |
60 | ||
61 | - 2 | |
62 | ||
63 | - 1 | |
64 | ||
65 | - 0 | |
66 | ||
0579e6e3 | 67 | - |
5377d91f MH |
68 | - 7 |
69 | ||
70 | - 6 | |
71 | ||
72 | - 5 | |
73 | ||
74 | - 4 | |
75 | ||
76 | - 3 | |
77 | ||
78 | - 2 | |
79 | ||
80 | - 1 | |
81 | ||
82 | - 0 | |
83 | ||
0579e6e3 | 84 | - |
5377d91f MH |
85 | - 7 |
86 | ||
87 | - 6 | |
88 | ||
89 | - 5 | |
90 | ||
91 | - 4 | |
92 | ||
93 | - 3 | |
94 | ||
95 | - 2 | |
96 | ||
97 | - 1 | |
98 | ||
99 | - 0 | |
100 | ||
0579e6e3 | 101 | - |
5377d91f MH |
102 | - 7 |
103 | ||
104 | - 6 | |
105 | ||
106 | - 5 | |
107 | ||
108 | - 4 | |
109 | ||
110 | - 3 | |
111 | ||
112 | - 2 | |
113 | ||
114 | - 1 | |
115 | ||
116 | - 0 | |
117 | ||
6aeb3f67 | 118 | - .. _V4L2-PIX-FMT-RGB332: |
5377d91f MH |
119 | |
120 | - ``V4L2_PIX_FMT_RGB332`` | |
121 | ||
122 | - 'RGB1' | |
123 | ||
0579e6e3 | 124 | - |
5377d91f MH |
125 | - r\ :sub:`2` |
126 | ||
127 | - r\ :sub:`1` | |
128 | ||
129 | - r\ :sub:`0` | |
130 | ||
131 | - g\ :sub:`2` | |
132 | ||
133 | - g\ :sub:`1` | |
134 | ||
135 | - g\ :sub:`0` | |
136 | ||
137 | - b\ :sub:`1` | |
138 | ||
139 | - b\ :sub:`0` | |
140 | ||
6aeb3f67 | 141 | - .. _V4L2-PIX-FMT-ARGB444: |
5377d91f MH |
142 | |
143 | - ``V4L2_PIX_FMT_ARGB444`` | |
144 | ||
145 | - 'AR12' | |
146 | ||
0579e6e3 | 147 | - |
5377d91f MH |
148 | - g\ :sub:`3` |
149 | ||
150 | - g\ :sub:`2` | |
151 | ||
152 | - g\ :sub:`1` | |
153 | ||
154 | - g\ :sub:`0` | |
155 | ||
156 | - b\ :sub:`3` | |
157 | ||
158 | - b\ :sub:`2` | |
159 | ||
160 | - b\ :sub:`1` | |
161 | ||
162 | - b\ :sub:`0` | |
163 | ||
0579e6e3 | 164 | - |
5377d91f MH |
165 | - a\ :sub:`3` |
166 | ||
167 | - a\ :sub:`2` | |
168 | ||
169 | - a\ :sub:`1` | |
170 | ||
171 | - a\ :sub:`0` | |
172 | ||
173 | - r\ :sub:`3` | |
174 | ||
175 | - r\ :sub:`2` | |
176 | ||
177 | - r\ :sub:`1` | |
178 | ||
179 | - r\ :sub:`0` | |
180 | ||
6aeb3f67 | 181 | - .. _V4L2-PIX-FMT-XRGB444: |
5377d91f MH |
182 | |
183 | - ``V4L2_PIX_FMT_XRGB444`` | |
184 | ||
185 | - 'XR12' | |
186 | ||
0579e6e3 | 187 | - |
5377d91f MH |
188 | - g\ :sub:`3` |
189 | ||
190 | - g\ :sub:`2` | |
191 | ||
192 | - g\ :sub:`1` | |
193 | ||
194 | - g\ :sub:`0` | |
195 | ||
196 | - b\ :sub:`3` | |
197 | ||
198 | - b\ :sub:`2` | |
199 | ||
200 | - b\ :sub:`1` | |
201 | ||
202 | - b\ :sub:`0` | |
203 | ||
0579e6e3 | 204 | - |
5377d91f MH |
205 | - - |
206 | ||
207 | - - | |
208 | ||
209 | - - | |
210 | ||
211 | - - | |
212 | ||
213 | - r\ :sub:`3` | |
214 | ||
215 | - r\ :sub:`2` | |
216 | ||
217 | - r\ :sub:`1` | |
218 | ||
219 | - r\ :sub:`0` | |
220 | ||
6aeb3f67 | 221 | - .. _V4L2-PIX-FMT-ARGB555: |
5377d91f MH |
222 | |
223 | - ``V4L2_PIX_FMT_ARGB555`` | |
224 | ||
225 | - 'AR15' | |
226 | ||
0579e6e3 | 227 | - |
5377d91f MH |
228 | - g\ :sub:`2` |
229 | ||
230 | - g\ :sub:`1` | |
231 | ||
232 | - g\ :sub:`0` | |
233 | ||
234 | - b\ :sub:`4` | |
235 | ||
236 | - b\ :sub:`3` | |
237 | ||
238 | - b\ :sub:`2` | |
239 | ||
240 | - b\ :sub:`1` | |
241 | ||
242 | - b\ :sub:`0` | |
243 | ||
0579e6e3 | 244 | - |
5377d91f MH |
245 | - a |
246 | ||
247 | - r\ :sub:`4` | |
248 | ||
249 | - r\ :sub:`3` | |
250 | ||
251 | - r\ :sub:`2` | |
252 | ||
253 | - r\ :sub:`1` | |
254 | ||
255 | - r\ :sub:`0` | |
256 | ||
257 | - g\ :sub:`4` | |
258 | ||
259 | - g\ :sub:`3` | |
260 | ||
6aeb3f67 | 261 | - .. _V4L2-PIX-FMT-XRGB555: |
5377d91f MH |
262 | |
263 | - ``V4L2_PIX_FMT_XRGB555`` | |
264 | ||
265 | - 'XR15' | |
266 | ||
0579e6e3 | 267 | - |
5377d91f MH |
268 | - g\ :sub:`2` |
269 | ||
270 | - g\ :sub:`1` | |
271 | ||
272 | - g\ :sub:`0` | |
273 | ||
274 | - b\ :sub:`4` | |
275 | ||
276 | - b\ :sub:`3` | |
277 | ||
278 | - b\ :sub:`2` | |
279 | ||
280 | - b\ :sub:`1` | |
281 | ||
282 | - b\ :sub:`0` | |
283 | ||
0579e6e3 | 284 | - |
5377d91f MH |
285 | - - |
286 | ||
287 | - r\ :sub:`4` | |
288 | ||
289 | - r\ :sub:`3` | |
290 | ||
291 | - r\ :sub:`2` | |
292 | ||
293 | - r\ :sub:`1` | |
294 | ||
295 | - r\ :sub:`0` | |
296 | ||
297 | - g\ :sub:`4` | |
298 | ||
299 | - g\ :sub:`3` | |
300 | ||
6aeb3f67 | 301 | - .. _V4L2-PIX-FMT-RGB565: |
5377d91f MH |
302 | |
303 | - ``V4L2_PIX_FMT_RGB565`` | |
304 | ||
305 | - 'RGBP' | |
306 | ||
0579e6e3 | 307 | - |
5377d91f MH |
308 | - g\ :sub:`2` |
309 | ||
310 | - g\ :sub:`1` | |
311 | ||
312 | - g\ :sub:`0` | |
313 | ||
314 | - b\ :sub:`4` | |
315 | ||
316 | - b\ :sub:`3` | |
317 | ||
318 | - b\ :sub:`2` | |
319 | ||
320 | - b\ :sub:`1` | |
321 | ||
322 | - b\ :sub:`0` | |
323 | ||
0579e6e3 | 324 | - |
5377d91f MH |
325 | - r\ :sub:`4` |
326 | ||
327 | - r\ :sub:`3` | |
328 | ||
329 | - r\ :sub:`2` | |
330 | ||
331 | - r\ :sub:`1` | |
332 | ||
333 | - r\ :sub:`0` | |
334 | ||
335 | - g\ :sub:`5` | |
336 | ||
337 | - g\ :sub:`4` | |
338 | ||
339 | - g\ :sub:`3` | |
340 | ||
6aeb3f67 | 341 | - .. _V4L2-PIX-FMT-ARGB555X: |
5377d91f MH |
342 | |
343 | - ``V4L2_PIX_FMT_ARGB555X`` | |
344 | ||
345 | - 'AR15' | (1 << 31) | |
346 | ||
0579e6e3 | 347 | - |
5377d91f MH |
348 | - a |
349 | ||
350 | - r\ :sub:`4` | |
351 | ||
352 | - r\ :sub:`3` | |
353 | ||
354 | - r\ :sub:`2` | |
355 | ||
356 | - r\ :sub:`1` | |
357 | ||
358 | - r\ :sub:`0` | |
359 | ||
360 | - g\ :sub:`4` | |
361 | ||
362 | - g\ :sub:`3` | |
363 | ||
0579e6e3 | 364 | - |
5377d91f MH |
365 | - g\ :sub:`2` |
366 | ||
367 | - g\ :sub:`1` | |
368 | ||
369 | - g\ :sub:`0` | |
370 | ||
371 | - b\ :sub:`4` | |
372 | ||
373 | - b\ :sub:`3` | |
374 | ||
375 | - b\ :sub:`2` | |
376 | ||
377 | - b\ :sub:`1` | |
378 | ||
379 | - b\ :sub:`0` | |
380 | ||
6aeb3f67 | 381 | - .. _V4L2-PIX-FMT-XRGB555X: |
5377d91f MH |
382 | |
383 | - ``V4L2_PIX_FMT_XRGB555X`` | |
384 | ||
385 | - 'XR15' | (1 << 31) | |
386 | ||
0579e6e3 | 387 | - |
5377d91f MH |
388 | - - |
389 | ||
390 | - r\ :sub:`4` | |
391 | ||
392 | - r\ :sub:`3` | |
393 | ||
394 | - r\ :sub:`2` | |
395 | ||
396 | - r\ :sub:`1` | |
397 | ||
398 | - r\ :sub:`0` | |
399 | ||
400 | - g\ :sub:`4` | |
401 | ||
402 | - g\ :sub:`3` | |
403 | ||
0579e6e3 | 404 | - |
5377d91f MH |
405 | - g\ :sub:`2` |
406 | ||
407 | - g\ :sub:`1` | |
408 | ||
409 | - g\ :sub:`0` | |
410 | ||
411 | - b\ :sub:`4` | |
412 | ||
413 | - b\ :sub:`3` | |
414 | ||
415 | - b\ :sub:`2` | |
416 | ||
417 | - b\ :sub:`1` | |
418 | ||
419 | - b\ :sub:`0` | |
420 | ||
6aeb3f67 | 421 | - .. _V4L2-PIX-FMT-RGB565X: |
5377d91f MH |
422 | |
423 | - ``V4L2_PIX_FMT_RGB565X`` | |
424 | ||
425 | - 'RGBR' | |
426 | ||
0579e6e3 | 427 | - |
5377d91f MH |
428 | - r\ :sub:`4` |
429 | ||
430 | - r\ :sub:`3` | |
431 | ||
432 | - r\ :sub:`2` | |
433 | ||
434 | - r\ :sub:`1` | |
435 | ||
436 | - r\ :sub:`0` | |
437 | ||
438 | - g\ :sub:`5` | |
439 | ||
440 | - g\ :sub:`4` | |
441 | ||
442 | - g\ :sub:`3` | |
443 | ||
0579e6e3 | 444 | - |
5377d91f MH |
445 | - g\ :sub:`2` |
446 | ||
447 | - g\ :sub:`1` | |
448 | ||
449 | - g\ :sub:`0` | |
450 | ||
451 | - b\ :sub:`4` | |
452 | ||
453 | - b\ :sub:`3` | |
454 | ||
455 | - b\ :sub:`2` | |
456 | ||
457 | - b\ :sub:`1` | |
458 | ||
459 | - b\ :sub:`0` | |
460 | ||
6aeb3f67 | 461 | - .. _V4L2-PIX-FMT-BGR24: |
5377d91f MH |
462 | |
463 | - ``V4L2_PIX_FMT_BGR24`` | |
464 | ||
465 | - 'BGR3' | |
466 | ||
0579e6e3 | 467 | - |
5377d91f MH |
468 | - b\ :sub:`7` |
469 | ||
470 | - b\ :sub:`6` | |
471 | ||
472 | - b\ :sub:`5` | |
473 | ||
474 | - b\ :sub:`4` | |
475 | ||
476 | - b\ :sub:`3` | |
477 | ||
478 | - b\ :sub:`2` | |
479 | ||
480 | - b\ :sub:`1` | |
481 | ||
482 | - b\ :sub:`0` | |
483 | ||
0579e6e3 | 484 | - |
5377d91f MH |
485 | - g\ :sub:`7` |
486 | ||
487 | - g\ :sub:`6` | |
488 | ||
489 | - g\ :sub:`5` | |
490 | ||
491 | - g\ :sub:`4` | |
492 | ||
493 | - g\ :sub:`3` | |
494 | ||
495 | - g\ :sub:`2` | |
496 | ||
497 | - g\ :sub:`1` | |
498 | ||
499 | - g\ :sub:`0` | |
500 | ||
0579e6e3 | 501 | - |
5377d91f MH |
502 | - r\ :sub:`7` |
503 | ||
504 | - r\ :sub:`6` | |
505 | ||
506 | - r\ :sub:`5` | |
507 | ||
508 | - r\ :sub:`4` | |
509 | ||
510 | - r\ :sub:`3` | |
511 | ||
512 | - r\ :sub:`2` | |
513 | ||
514 | - r\ :sub:`1` | |
515 | ||
516 | - r\ :sub:`0` | |
517 | ||
6aeb3f67 | 518 | - .. _V4L2-PIX-FMT-RGB24: |
5377d91f MH |
519 | |
520 | - ``V4L2_PIX_FMT_RGB24`` | |
521 | ||
522 | - 'RGB3' | |
523 | ||
0579e6e3 | 524 | - |
5377d91f MH |
525 | - r\ :sub:`7` |
526 | ||
527 | - r\ :sub:`6` | |
528 | ||
529 | - r\ :sub:`5` | |
530 | ||
531 | - r\ :sub:`4` | |
532 | ||
533 | - r\ :sub:`3` | |
534 | ||
535 | - r\ :sub:`2` | |
536 | ||
537 | - r\ :sub:`1` | |
538 | ||
539 | - r\ :sub:`0` | |
540 | ||
0579e6e3 | 541 | - |
5377d91f MH |
542 | - g\ :sub:`7` |
543 | ||
544 | - g\ :sub:`6` | |
545 | ||
546 | - g\ :sub:`5` | |
547 | ||
548 | - g\ :sub:`4` | |
549 | ||
550 | - g\ :sub:`3` | |
551 | ||
552 | - g\ :sub:`2` | |
553 | ||
554 | - g\ :sub:`1` | |
555 | ||
556 | - g\ :sub:`0` | |
557 | ||
0579e6e3 | 558 | - |
5377d91f MH |
559 | - b\ :sub:`7` |
560 | ||
561 | - b\ :sub:`6` | |
562 | ||
563 | - b\ :sub:`5` | |
564 | ||
565 | - b\ :sub:`4` | |
566 | ||
567 | - b\ :sub:`3` | |
568 | ||
569 | - b\ :sub:`2` | |
570 | ||
571 | - b\ :sub:`1` | |
572 | ||
573 | - b\ :sub:`0` | |
574 | ||
6aeb3f67 | 575 | - .. _V4L2-PIX-FMT-BGR666: |
5377d91f MH |
576 | |
577 | - ``V4L2_PIX_FMT_BGR666`` | |
578 | ||
579 | - 'BGRH' | |
580 | ||
0579e6e3 | 581 | - |
5377d91f MH |
582 | - b\ :sub:`5` |
583 | ||
584 | - b\ :sub:`4` | |
585 | ||
586 | - b\ :sub:`3` | |
587 | ||
588 | - b\ :sub:`2` | |
589 | ||
590 | - b\ :sub:`1` | |
591 | ||
592 | - b\ :sub:`0` | |
593 | ||
594 | - g\ :sub:`5` | |
595 | ||
596 | - g\ :sub:`4` | |
597 | ||
0579e6e3 | 598 | - |
5377d91f MH |
599 | - g\ :sub:`3` |
600 | ||
601 | - g\ :sub:`2` | |
602 | ||
603 | - g\ :sub:`1` | |
604 | ||
605 | - g\ :sub:`0` | |
606 | ||
607 | - r\ :sub:`5` | |
608 | ||
609 | - r\ :sub:`4` | |
610 | ||
611 | - r\ :sub:`3` | |
612 | ||
613 | - r\ :sub:`2` | |
614 | ||
0579e6e3 | 615 | - |
5377d91f MH |
616 | - r\ :sub:`1` |
617 | ||
618 | - r\ :sub:`0` | |
619 | ||
620 | - - | |
621 | ||
622 | - - | |
623 | ||
624 | - - | |
625 | ||
626 | - - | |
627 | ||
628 | - - | |
629 | ||
630 | - - | |
631 | ||
0579e6e3 | 632 | - |
5377d91f MH |
633 | - - |
634 | ||
635 | - - | |
636 | ||
637 | - - | |
638 | ||
639 | - - | |
640 | ||
641 | - - | |
642 | ||
643 | - - | |
644 | ||
645 | - - | |
646 | ||
647 | - - | |
648 | ||
6aeb3f67 | 649 | - .. _V4L2-PIX-FMT-ABGR32: |
5377d91f MH |
650 | |
651 | - ``V4L2_PIX_FMT_ABGR32`` | |
652 | ||
653 | - 'AR24' | |
654 | ||
0579e6e3 | 655 | - |
5377d91f MH |
656 | - b\ :sub:`7` |
657 | ||
658 | - b\ :sub:`6` | |
659 | ||
660 | - b\ :sub:`5` | |
661 | ||
662 | - b\ :sub:`4` | |
663 | ||
664 | - b\ :sub:`3` | |
665 | ||
666 | - b\ :sub:`2` | |
667 | ||
668 | - b\ :sub:`1` | |
669 | ||
670 | - b\ :sub:`0` | |
671 | ||
0579e6e3 | 672 | - |
5377d91f MH |
673 | - g\ :sub:`7` |
674 | ||
675 | - g\ :sub:`6` | |
676 | ||
677 | - g\ :sub:`5` | |
678 | ||
679 | - g\ :sub:`4` | |
680 | ||
681 | - g\ :sub:`3` | |
682 | ||
683 | - g\ :sub:`2` | |
684 | ||
685 | - g\ :sub:`1` | |
686 | ||
687 | - g\ :sub:`0` | |
688 | ||
0579e6e3 | 689 | - |
5377d91f MH |
690 | - r\ :sub:`7` |
691 | ||
692 | - r\ :sub:`6` | |
693 | ||
694 | - r\ :sub:`5` | |
695 | ||
696 | - r\ :sub:`4` | |
697 | ||
698 | - r\ :sub:`3` | |
699 | ||
700 | - r\ :sub:`2` | |
701 | ||
702 | - r\ :sub:`1` | |
703 | ||
704 | - r\ :sub:`0` | |
705 | ||
0579e6e3 | 706 | - |
5377d91f MH |
707 | - a\ :sub:`7` |
708 | ||
709 | - a\ :sub:`6` | |
710 | ||
711 | - a\ :sub:`5` | |
712 | ||
713 | - a\ :sub:`4` | |
714 | ||
715 | - a\ :sub:`3` | |
716 | ||
717 | - a\ :sub:`2` | |
718 | ||
719 | - a\ :sub:`1` | |
720 | ||
721 | - a\ :sub:`0` | |
722 | ||
6aeb3f67 | 723 | - .. _V4L2-PIX-FMT-XBGR32: |
5377d91f MH |
724 | |
725 | - ``V4L2_PIX_FMT_XBGR32`` | |
726 | ||
727 | - 'XR24' | |
728 | ||
0579e6e3 | 729 | - |
5377d91f MH |
730 | - b\ :sub:`7` |
731 | ||
732 | - b\ :sub:`6` | |
733 | ||
734 | - b\ :sub:`5` | |
735 | ||
736 | - b\ :sub:`4` | |
737 | ||
738 | - b\ :sub:`3` | |
739 | ||
740 | - b\ :sub:`2` | |
741 | ||
742 | - b\ :sub:`1` | |
743 | ||
744 | - b\ :sub:`0` | |
745 | ||
0579e6e3 | 746 | - |
5377d91f MH |
747 | - g\ :sub:`7` |
748 | ||
749 | - g\ :sub:`6` | |
750 | ||
751 | - g\ :sub:`5` | |
752 | ||
753 | - g\ :sub:`4` | |
754 | ||
755 | - g\ :sub:`3` | |
756 | ||
757 | - g\ :sub:`2` | |
758 | ||
759 | - g\ :sub:`1` | |
760 | ||
761 | - g\ :sub:`0` | |
762 | ||
0579e6e3 | 763 | - |
5377d91f MH |
764 | - r\ :sub:`7` |
765 | ||
766 | - r\ :sub:`6` | |
767 | ||
768 | - r\ :sub:`5` | |
769 | ||
770 | - r\ :sub:`4` | |
771 | ||
772 | - r\ :sub:`3` | |
773 | ||
774 | - r\ :sub:`2` | |
775 | ||
776 | - r\ :sub:`1` | |
777 | ||
778 | - r\ :sub:`0` | |
779 | ||
0579e6e3 | 780 | - |
5377d91f MH |
781 | - - |
782 | ||
783 | - - | |
784 | ||
785 | - - | |
786 | ||
787 | - - | |
788 | ||
789 | - - | |
790 | ||
791 | - - | |
792 | ||
793 | - - | |
794 | ||
795 | - - | |
796 | ||
6aeb3f67 | 797 | - .. _V4L2-PIX-FMT-ARGB32: |
5377d91f MH |
798 | |
799 | - ``V4L2_PIX_FMT_ARGB32`` | |
800 | ||
801 | - 'BA24' | |
802 | ||
0579e6e3 | 803 | - |
5377d91f MH |
804 | - a\ :sub:`7` |
805 | ||
806 | - a\ :sub:`6` | |
807 | ||
808 | - a\ :sub:`5` | |
809 | ||
810 | - a\ :sub:`4` | |
811 | ||
812 | - a\ :sub:`3` | |
813 | ||
814 | - a\ :sub:`2` | |
815 | ||
816 | - a\ :sub:`1` | |
817 | ||
818 | - a\ :sub:`0` | |
819 | ||
0579e6e3 | 820 | - |
5377d91f MH |
821 | - r\ :sub:`7` |
822 | ||
823 | - r\ :sub:`6` | |
824 | ||
825 | - r\ :sub:`5` | |
826 | ||
827 | - r\ :sub:`4` | |
828 | ||
829 | - r\ :sub:`3` | |
830 | ||
831 | - r\ :sub:`2` | |
832 | ||
833 | - r\ :sub:`1` | |
834 | ||
835 | - r\ :sub:`0` | |
836 | ||
0579e6e3 | 837 | - |
5377d91f MH |
838 | - g\ :sub:`7` |
839 | ||
840 | - g\ :sub:`6` | |
841 | ||
842 | - g\ :sub:`5` | |
843 | ||
844 | - g\ :sub:`4` | |
845 | ||
846 | - g\ :sub:`3` | |
847 | ||
848 | - g\ :sub:`2` | |
849 | ||
850 | - g\ :sub:`1` | |
851 | ||
852 | - g\ :sub:`0` | |
853 | ||
0579e6e3 | 854 | - |
5377d91f MH |
855 | - b\ :sub:`7` |
856 | ||
857 | - b\ :sub:`6` | |
858 | ||
859 | - b\ :sub:`5` | |
860 | ||
861 | - b\ :sub:`4` | |
862 | ||
863 | - b\ :sub:`3` | |
864 | ||
865 | - b\ :sub:`2` | |
866 | ||
867 | - b\ :sub:`1` | |
868 | ||
869 | - b\ :sub:`0` | |
870 | ||
6aeb3f67 | 871 | - .. _V4L2-PIX-FMT-XRGB32: |
5377d91f MH |
872 | |
873 | - ``V4L2_PIX_FMT_XRGB32`` | |
874 | ||
875 | - 'BX24' | |
876 | ||
0579e6e3 | 877 | - |
5377d91f MH |
878 | - - |
879 | ||
880 | - - | |
881 | ||
882 | - - | |
883 | ||
884 | - - | |
885 | ||
886 | - - | |
887 | ||
888 | - - | |
889 | ||
890 | - - | |
891 | ||
892 | - - | |
893 | ||
0579e6e3 | 894 | - |
5377d91f MH |
895 | - r\ :sub:`7` |
896 | ||
897 | - r\ :sub:`6` | |
898 | ||
899 | - r\ :sub:`5` | |
900 | ||
901 | - r\ :sub:`4` | |
902 | ||
903 | - r\ :sub:`3` | |
904 | ||
905 | - r\ :sub:`2` | |
906 | ||
907 | - r\ :sub:`1` | |
908 | ||
909 | - r\ :sub:`0` | |
910 | ||
0579e6e3 | 911 | - |
5377d91f MH |
912 | - g\ :sub:`7` |
913 | ||
914 | - g\ :sub:`6` | |
915 | ||
916 | - g\ :sub:`5` | |
917 | ||
918 | - g\ :sub:`4` | |
919 | ||
920 | - g\ :sub:`3` | |
921 | ||
922 | - g\ :sub:`2` | |
923 | ||
924 | - g\ :sub:`1` | |
925 | ||
926 | - g\ :sub:`0` | |
927 | ||
0579e6e3 | 928 | - |
5377d91f MH |
929 | - b\ :sub:`7` |
930 | ||
931 | - b\ :sub:`6` | |
932 | ||
933 | - b\ :sub:`5` | |
934 | ||
935 | - b\ :sub:`4` | |
936 | ||
937 | - b\ :sub:`3` | |
938 | ||
939 | - b\ :sub:`2` | |
940 | ||
941 | - b\ :sub:`1` | |
942 | ||
943 | - b\ :sub:`0` | |
944 | ||
945 | ||
946 | Bit 7 is the most significant bit. | |
947 | ||
948 | The usage and value of the alpha bits (a) in the ARGB and ABGR formats | |
949 | (collectively referred to as alpha formats) depend on the device type | |
950 | and hardware operation. :ref:`Capture <capture>` devices (including | |
951 | capture queues of mem-to-mem devices) fill the alpha component in | |
952 | memory. When the device outputs an alpha channel the alpha component | |
953 | will have a meaningful value. Otherwise, when the device doesn't output | |
954 | an alpha channel but can set the alpha bit to a user-configurable value, | |
955 | the :ref:`V4L2_CID_ALPHA_COMPONENT <v4l2-alpha-component>` control | |
956 | is used to specify that alpha value, and the alpha component of all | |
957 | pixels will be set to the value specified by that control. Otherwise a | |
958 | corresponding format without an alpha component (XRGB or XBGR) must be | |
959 | used instead of an alpha format. | |
960 | ||
961 | :ref:`Output <output>` devices (including output queues of mem-to-mem | |
962 | devices and :ref:`video output overlay <osd>` devices) read the alpha | |
963 | component from memory. When the device processes the alpha channel the | |
964 | alpha component must be filled with meaningful values by applications. | |
965 | Otherwise a corresponding format without an alpha component (XRGB or | |
966 | XBGR) must be used instead of an alpha format. | |
967 | ||
968 | The XRGB and XBGR formats contain undefined bits (-). Applications, | |
969 | devices and drivers must ignore those bits, for both | |
7347081e | 970 | :ref:`capture` and :ref:`output` devices. |
5377d91f | 971 | |
056d2ee6 | 972 | **Byte Order.** |
5377d91f MH |
973 | Each cell is one byte. |
974 | ||
975 | ||
976 | ||
977 | .. flat-table:: | |
978 | :header-rows: 0 | |
979 | :stub-columns: 0 | |
980 | :widths: 2 1 1 1 1 1 1 1 1 1 1 1 1 | |
981 | ||
982 | ||
983 | - .. row 1 | |
984 | ||
985 | - start + 0: | |
986 | ||
987 | - B\ :sub:`00` | |
988 | ||
989 | - G\ :sub:`00` | |
990 | ||
991 | - R\ :sub:`00` | |
992 | ||
993 | - B\ :sub:`01` | |
994 | ||
995 | - G\ :sub:`01` | |
996 | ||
997 | - R\ :sub:`01` | |
998 | ||
999 | - B\ :sub:`02` | |
1000 | ||
1001 | - G\ :sub:`02` | |
1002 | ||
1003 | - R\ :sub:`02` | |
1004 | ||
1005 | - B\ :sub:`03` | |
1006 | ||
1007 | - G\ :sub:`03` | |
1008 | ||
1009 | - R\ :sub:`03` | |
1010 | ||
1011 | - .. row 2 | |
1012 | ||
1013 | - start + 12: | |
1014 | ||
1015 | - B\ :sub:`10` | |
1016 | ||
1017 | - G\ :sub:`10` | |
1018 | ||
1019 | - R\ :sub:`10` | |
1020 | ||
1021 | - B\ :sub:`11` | |
1022 | ||
1023 | - G\ :sub:`11` | |
1024 | ||
1025 | - R\ :sub:`11` | |
1026 | ||
1027 | - B\ :sub:`12` | |
1028 | ||
1029 | - G\ :sub:`12` | |
1030 | ||
1031 | - R\ :sub:`12` | |
1032 | ||
1033 | - B\ :sub:`13` | |
1034 | ||
1035 | - G\ :sub:`13` | |
1036 | ||
1037 | - R\ :sub:`13` | |
1038 | ||
1039 | - .. row 3 | |
1040 | ||
1041 | - start + 24: | |
1042 | ||
1043 | - B\ :sub:`20` | |
1044 | ||
1045 | - G\ :sub:`20` | |
1046 | ||
1047 | - R\ :sub:`20` | |
1048 | ||
1049 | - B\ :sub:`21` | |
1050 | ||
1051 | - G\ :sub:`21` | |
1052 | ||
1053 | - R\ :sub:`21` | |
1054 | ||
1055 | - B\ :sub:`22` | |
1056 | ||
1057 | - G\ :sub:`22` | |
1058 | ||
1059 | - R\ :sub:`22` | |
1060 | ||
1061 | - B\ :sub:`23` | |
1062 | ||
1063 | - G\ :sub:`23` | |
1064 | ||
1065 | - R\ :sub:`23` | |
1066 | ||
1067 | - .. row 4 | |
1068 | ||
1069 | - start + 36: | |
1070 | ||
1071 | - B\ :sub:`30` | |
1072 | ||
1073 | - G\ :sub:`30` | |
1074 | ||
1075 | - R\ :sub:`30` | |
1076 | ||
1077 | - B\ :sub:`31` | |
1078 | ||
1079 | - G\ :sub:`31` | |
1080 | ||
1081 | - R\ :sub:`31` | |
1082 | ||
1083 | - B\ :sub:`32` | |
1084 | ||
1085 | - G\ :sub:`32` | |
1086 | ||
1087 | - R\ :sub:`32` | |
1088 | ||
1089 | - B\ :sub:`33` | |
1090 | ||
1091 | - G\ :sub:`33` | |
1092 | ||
1093 | - R\ :sub:`33` | |
1094 | ||
1095 | ||
1096 | Formats defined in :ref:`rgb-formats-deprecated` are deprecated and | |
1097 | must not be used by new drivers. They are documented here for reference. | |
1098 | The meaning of their alpha bits (a) is ill-defined and interpreted as in | |
1099 | either the corresponding ARGB or XRGB format, depending on the driver. | |
1100 | ||
1101 | ||
1102 | .. _rgb-formats-deprecated: | |
1103 | ||
1104 | .. flat-table:: Deprecated Packed RGB Image Formats | |
1105 | :header-rows: 2 | |
1106 | :stub-columns: 0 | |
1107 | ||
1108 | ||
1109 | - .. row 1 | |
1110 | ||
1111 | - Identifier | |
1112 | ||
1113 | - Code | |
1114 | ||
0579e6e3 | 1115 | - |
5377d91f MH |
1116 | - :cspan:`7` Byte 0 in memory |
1117 | ||
1118 | - :cspan:`7` Byte 1 | |
1119 | ||
1120 | - :cspan:`7` Byte 2 | |
1121 | ||
1122 | - :cspan:`7` Byte 3 | |
1123 | ||
1124 | - .. row 2 | |
1125 | ||
0579e6e3 MCC |
1126 | - |
1127 | - | |
5377d91f MH |
1128 | - Bit |
1129 | ||
1130 | - 7 | |
1131 | ||
1132 | - 6 | |
1133 | ||
1134 | - 5 | |
1135 | ||
1136 | - 4 | |
1137 | ||
1138 | - 3 | |
1139 | ||
1140 | - 2 | |
1141 | ||
1142 | - 1 | |
1143 | ||
1144 | - 0 | |
1145 | ||
0579e6e3 | 1146 | - |
5377d91f MH |
1147 | - 7 |
1148 | ||
1149 | - 6 | |
1150 | ||
1151 | - 5 | |
1152 | ||
1153 | - 4 | |
1154 | ||
1155 | - 3 | |
1156 | ||
1157 | - 2 | |
1158 | ||
1159 | - 1 | |
1160 | ||
1161 | - 0 | |
1162 | ||
0579e6e3 | 1163 | - |
5377d91f MH |
1164 | - 7 |
1165 | ||
1166 | - 6 | |
1167 | ||
1168 | - 5 | |
1169 | ||
1170 | - 4 | |
1171 | ||
1172 | - 3 | |
1173 | ||
1174 | - 2 | |
1175 | ||
1176 | - 1 | |
1177 | ||
1178 | - 0 | |
1179 | ||
0579e6e3 | 1180 | - |
5377d91f MH |
1181 | - 7 |
1182 | ||
1183 | - 6 | |
1184 | ||
1185 | - 5 | |
1186 | ||
1187 | - 4 | |
1188 | ||
1189 | - 3 | |
1190 | ||
1191 | - 2 | |
1192 | ||
1193 | - 1 | |
1194 | ||
1195 | - 0 | |
1196 | ||
6aeb3f67 | 1197 | - .. _V4L2-PIX-FMT-RGB444: |
5377d91f MH |
1198 | |
1199 | - ``V4L2_PIX_FMT_RGB444`` | |
1200 | ||
1201 | - 'R444' | |
1202 | ||
0579e6e3 | 1203 | - |
5377d91f MH |
1204 | - g\ :sub:`3` |
1205 | ||
1206 | - g\ :sub:`2` | |
1207 | ||
1208 | - g\ :sub:`1` | |
1209 | ||
1210 | - g\ :sub:`0` | |
1211 | ||
1212 | - b\ :sub:`3` | |
1213 | ||
1214 | - b\ :sub:`2` | |
1215 | ||
1216 | - b\ :sub:`1` | |
1217 | ||
1218 | - b\ :sub:`0` | |
1219 | ||
0579e6e3 | 1220 | - |
5377d91f MH |
1221 | - a\ :sub:`3` |
1222 | ||
1223 | - a\ :sub:`2` | |
1224 | ||
1225 | - a\ :sub:`1` | |
1226 | ||
1227 | - a\ :sub:`0` | |
1228 | ||
1229 | - r\ :sub:`3` | |
1230 | ||
1231 | - r\ :sub:`2` | |
1232 | ||
1233 | - r\ :sub:`1` | |
1234 | ||
1235 | - r\ :sub:`0` | |
1236 | ||
6aeb3f67 | 1237 | - .. _V4L2-PIX-FMT-RGB555: |
5377d91f MH |
1238 | |
1239 | - ``V4L2_PIX_FMT_RGB555`` | |
1240 | ||
1241 | - 'RGBO' | |
1242 | ||
0579e6e3 | 1243 | - |
5377d91f MH |
1244 | - g\ :sub:`2` |
1245 | ||
1246 | - g\ :sub:`1` | |
1247 | ||
1248 | - g\ :sub:`0` | |
1249 | ||
1250 | - b\ :sub:`4` | |
1251 | ||
1252 | - b\ :sub:`3` | |
1253 | ||
1254 | - b\ :sub:`2` | |
1255 | ||
1256 | - b\ :sub:`1` | |
1257 | ||
1258 | - b\ :sub:`0` | |
1259 | ||
0579e6e3 | 1260 | - |
5377d91f MH |
1261 | - a |
1262 | ||
1263 | - r\ :sub:`4` | |
1264 | ||
1265 | - r\ :sub:`3` | |
1266 | ||
1267 | - r\ :sub:`2` | |
1268 | ||
1269 | - r\ :sub:`1` | |
1270 | ||
1271 | - r\ :sub:`0` | |
1272 | ||
1273 | - g\ :sub:`4` | |
1274 | ||
1275 | - g\ :sub:`3` | |
1276 | ||
6aeb3f67 | 1277 | - .. _V4L2-PIX-FMT-RGB555X: |
5377d91f MH |
1278 | |
1279 | - ``V4L2_PIX_FMT_RGB555X`` | |
1280 | ||
1281 | - 'RGBQ' | |
1282 | ||
0579e6e3 | 1283 | - |
5377d91f MH |
1284 | - a |
1285 | ||
1286 | - r\ :sub:`4` | |
1287 | ||
1288 | - r\ :sub:`3` | |
1289 | ||
1290 | - r\ :sub:`2` | |
1291 | ||
1292 | - r\ :sub:`1` | |
1293 | ||
1294 | - r\ :sub:`0` | |
1295 | ||
1296 | - g\ :sub:`4` | |
1297 | ||
1298 | - g\ :sub:`3` | |
1299 | ||
0579e6e3 | 1300 | - |
5377d91f MH |
1301 | - g\ :sub:`2` |
1302 | ||
1303 | - g\ :sub:`1` | |
1304 | ||
1305 | - g\ :sub:`0` | |
1306 | ||
1307 | - b\ :sub:`4` | |
1308 | ||
1309 | - b\ :sub:`3` | |
1310 | ||
1311 | - b\ :sub:`2` | |
1312 | ||
1313 | - b\ :sub:`1` | |
1314 | ||
1315 | - b\ :sub:`0` | |
1316 | ||
6aeb3f67 | 1317 | - .. _V4L2-PIX-FMT-BGR32: |
5377d91f MH |
1318 | |
1319 | - ``V4L2_PIX_FMT_BGR32`` | |
1320 | ||
1321 | - 'BGR4' | |
1322 | ||
0579e6e3 | 1323 | - |
5377d91f MH |
1324 | - b\ :sub:`7` |
1325 | ||
1326 | - b\ :sub:`6` | |
1327 | ||
1328 | - b\ :sub:`5` | |
1329 | ||
1330 | - b\ :sub:`4` | |
1331 | ||
1332 | - b\ :sub:`3` | |
1333 | ||
1334 | - b\ :sub:`2` | |
1335 | ||
1336 | - b\ :sub:`1` | |
1337 | ||
1338 | - b\ :sub:`0` | |
1339 | ||
0579e6e3 | 1340 | - |
5377d91f MH |
1341 | - g\ :sub:`7` |
1342 | ||
1343 | - g\ :sub:`6` | |
1344 | ||
1345 | - g\ :sub:`5` | |
1346 | ||
1347 | - g\ :sub:`4` | |
1348 | ||
1349 | - g\ :sub:`3` | |
1350 | ||
1351 | - g\ :sub:`2` | |
1352 | ||
1353 | - g\ :sub:`1` | |
1354 | ||
1355 | - g\ :sub:`0` | |
1356 | ||
0579e6e3 | 1357 | - |
5377d91f MH |
1358 | - r\ :sub:`7` |
1359 | ||
1360 | - r\ :sub:`6` | |
1361 | ||
1362 | - r\ :sub:`5` | |
1363 | ||
1364 | - r\ :sub:`4` | |
1365 | ||
1366 | - r\ :sub:`3` | |
1367 | ||
1368 | - r\ :sub:`2` | |
1369 | ||
1370 | - r\ :sub:`1` | |
1371 | ||
1372 | - r\ :sub:`0` | |
1373 | ||
0579e6e3 | 1374 | - |
5377d91f MH |
1375 | - a\ :sub:`7` |
1376 | ||
1377 | - a\ :sub:`6` | |
1378 | ||
1379 | - a\ :sub:`5` | |
1380 | ||
1381 | - a\ :sub:`4` | |
1382 | ||
1383 | - a\ :sub:`3` | |
1384 | ||
1385 | - a\ :sub:`2` | |
1386 | ||
1387 | - a\ :sub:`1` | |
1388 | ||
1389 | - a\ :sub:`0` | |
1390 | ||
6aeb3f67 | 1391 | - .. _V4L2-PIX-FMT-RGB32: |
5377d91f MH |
1392 | |
1393 | - ``V4L2_PIX_FMT_RGB32`` | |
1394 | ||
1395 | - 'RGB4' | |
1396 | ||
0579e6e3 | 1397 | - |
5377d91f MH |
1398 | - a\ :sub:`7` |
1399 | ||
1400 | - a\ :sub:`6` | |
1401 | ||
1402 | - a\ :sub:`5` | |
1403 | ||
1404 | - a\ :sub:`4` | |
1405 | ||
1406 | - a\ :sub:`3` | |
1407 | ||
1408 | - a\ :sub:`2` | |
1409 | ||
1410 | - a\ :sub:`1` | |
1411 | ||
1412 | - a\ :sub:`0` | |
1413 | ||
0579e6e3 | 1414 | - |
5377d91f MH |
1415 | - r\ :sub:`7` |
1416 | ||
1417 | - r\ :sub:`6` | |
1418 | ||
1419 | - r\ :sub:`5` | |
1420 | ||
1421 | - r\ :sub:`4` | |
1422 | ||
1423 | - r\ :sub:`3` | |
1424 | ||
1425 | - r\ :sub:`2` | |
1426 | ||
1427 | - r\ :sub:`1` | |
1428 | ||
1429 | - r\ :sub:`0` | |
1430 | ||
0579e6e3 | 1431 | - |
5377d91f MH |
1432 | - g\ :sub:`7` |
1433 | ||
1434 | - g\ :sub:`6` | |
1435 | ||
1436 | - g\ :sub:`5` | |
1437 | ||
1438 | - g\ :sub:`4` | |
1439 | ||
1440 | - g\ :sub:`3` | |
1441 | ||
1442 | - g\ :sub:`2` | |
1443 | ||
1444 | - g\ :sub:`1` | |
1445 | ||
1446 | - g\ :sub:`0` | |
1447 | ||
0579e6e3 | 1448 | - |
5377d91f MH |
1449 | - b\ :sub:`7` |
1450 | ||
1451 | - b\ :sub:`6` | |
1452 | ||
1453 | - b\ :sub:`5` | |
1454 | ||
1455 | - b\ :sub:`4` | |
1456 | ||
1457 | - b\ :sub:`3` | |
1458 | ||
1459 | - b\ :sub:`2` | |
1460 | ||
1461 | - b\ :sub:`1` | |
1462 | ||
1463 | - b\ :sub:`0` | |
1464 | ||
1465 | ||
1466 | A test utility to determine which RGB formats a driver actually supports | |
1467 | is available from the LinuxTV v4l-dvb repository. See | |
1468 | `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access | |
1469 | instructions. |