Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst

   1 .. Permission is granted to copy, distribute and/or modify this
   2 .. document under the terms of the GNU Free Documentation License,
   3 .. Version 1.1 or any later version published by the Free Software
   4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
   5 .. and no Back-Cover Texts. A copy of the license is included at
   6 .. Documentation/media/uapi/fdl-appendix.rst.
   7 ..
   8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
   9
  10 .. _packed-rgb:
  11
  12 ******************
  13 Packed RGB formats
  14 ******************
  15
  16 Description
  17 ===========
  18
  19 These formats are designed to match the pixel formats of typical PC
  20 graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel.
  21 These are all packed-pixel formats, meaning all the data for a pixel lie
  22 next to each other in memory.
  23
  24 .. raw:: latex
  25
  26     \begingroup
  27     \tiny
  28     \setlength{\tabcolsep}{2pt}
  29
  30 .. tabularcolumns:: |p{2.3cm}|p{1.6cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|
  31
  32
  33 .. _rgb-formats:
  34
  35 .. flat-table:: Packed RGB Image Formats
  36     :header-rows:  2
  37     :stub-columns: 0
  38
  39     * - Identifier
  40       - Code
  41       - :cspan:`7` Byte 0 in memory
  42       - :cspan:`7` Byte 1
  43       - :cspan:`7` Byte 2
  44       - :cspan:`7` Byte 3
  45     * -
  46       -
  47       - 7
  48       - 6
  49       - 5
  50       - 4
  51       - 3
  52       - 2
  53       - 1
  54       - 0
  55
  56       - 7
  57       - 6
  58       - 5
  59       - 4
  60       - 3
  61       - 2
  62       - 1
  63       - 0
  64
  65       - 7
  66       - 6
  67       - 5
  68       - 4
  69       - 3
  70       - 2
  71       - 1
  72       - 0
  73
  74       - 7
  75       - 6
  76       - 5
  77       - 4
  78       - 3
  79       - 2
  80       - 1
  81       - 0
  82     * .. _V4L2-PIX-FMT-RGB332:
  83
  84       - ``V4L2_PIX_FMT_RGB332``
  85       - 'RGB1'
  86
  87       - r\ :sub:`2`
  88       - r\ :sub:`1`
  89       - r\ :sub:`0`
  90       - g\ :sub:`2`
  91       - g\ :sub:`1`
  92       - g\ :sub:`0`
  93       - b\ :sub:`1`
  94       - b\ :sub:`0`
  95       -
  96     * .. _V4L2-PIX-FMT-ARGB444:
  97
  98       - ``V4L2_PIX_FMT_ARGB444``
  99       - 'AR12'
 100
 101       - g\ :sub:`3`
 102       - g\ :sub:`2`
 103       - g\ :sub:`1`
 104       - g\ :sub:`0`
 105       - b\ :sub:`3`
 106       - b\ :sub:`2`
 107       - b\ :sub:`1`
 108       - b\ :sub:`0`
 109
 110       - a\ :sub:`3`
 111       - a\ :sub:`2`
 112       - a\ :sub:`1`
 113       - a\ :sub:`0`
 114       - r\ :sub:`3`
 115       - r\ :sub:`2`
 116       - r\ :sub:`1`
 117       - r\ :sub:`0`
 118       -
 119     * .. _V4L2-PIX-FMT-XRGB444:
 120
 121       - ``V4L2_PIX_FMT_XRGB444``
 122       - 'XR12'
 123
 124       - g\ :sub:`3`
 125       - g\ :sub:`2`
 126       - g\ :sub:`1`
 127       - g\ :sub:`0`
 128       - b\ :sub:`3`
 129       - b\ :sub:`2`
 130       - b\ :sub:`1`
 131       - b\ :sub:`0`
 132
 133       -
 134       -
 135       -
 136       -
 137       - r\ :sub:`3`
 138       - r\ :sub:`2`
 139       - r\ :sub:`1`
 140       - r\ :sub:`0`
 141       -
 142     * .. _V4L2-PIX-FMT-ARGB555:
 143
 144       - ``V4L2_PIX_FMT_ARGB555``
 145       - 'AR15'
 146
 147       - g\ :sub:`2`
 148       - g\ :sub:`1`
 149       - g\ :sub:`0`
 150       - b\ :sub:`4`
 151       - b\ :sub:`3`
 152       - b\ :sub:`2`
 153       - b\ :sub:`1`
 154       - b\ :sub:`0`
 155
 156       - a
 157       - r\ :sub:`4`
 158       - r\ :sub:`3`
 159       - r\ :sub:`2`
 160       - r\ :sub:`1`
 161       - r\ :sub:`0`
 162       - g\ :sub:`4`
 163       - g\ :sub:`3`
 164       -
 165     * .. _V4L2-PIX-FMT-XRGB555:
 166
 167       - ``V4L2_PIX_FMT_XRGB555``
 168       - 'XR15'
 169
 170       - g\ :sub:`2`
 171       - g\ :sub:`1`
 172       - g\ :sub:`0`
 173       - b\ :sub:`4`
 174       - b\ :sub:`3`
 175       - b\ :sub:`2`
 176       - b\ :sub:`1`
 177       - b\ :sub:`0`
 178
 179       -
 180       - r\ :sub:`4`
 181       - r\ :sub:`3`
 182       - r\ :sub:`2`
 183       - r\ :sub:`1`
 184       - r\ :sub:`0`
 185       - g\ :sub:`4`
 186       - g\ :sub:`3`
 187       -
 188     * .. _V4L2-PIX-FMT-RGB565:
 189
 190       - ``V4L2_PIX_FMT_RGB565``
 191       - 'RGBP'
 192
 193       - g\ :sub:`2`
 194       - g\ :sub:`1`
 195       - g\ :sub:`0`
 196       - b\ :sub:`4`
 197       - b\ :sub:`3`
 198       - b\ :sub:`2`
 199       - b\ :sub:`1`
 200       - b\ :sub:`0`
 201
 202       - r\ :sub:`4`
 203       - r\ :sub:`3`
 204       - r\ :sub:`2`
 205       - r\ :sub:`1`
 206       - r\ :sub:`0`
 207       - g\ :sub:`5`
 208       - g\ :sub:`4`
 209       - g\ :sub:`3`
 210       -
 211     * .. _V4L2-PIX-FMT-ARGB555X:
 212
 213       - ``V4L2_PIX_FMT_ARGB555X``
 214       - 'AR15' | (1 << 31)
 215
 216       - a
 217       - r\ :sub:`4`
 218       - r\ :sub:`3`
 219       - r\ :sub:`2`
 220       - r\ :sub:`1`
 221       - r\ :sub:`0`
 222       - g\ :sub:`4`
 223       - g\ :sub:`3`
 224
 225       - g\ :sub:`2`
 226       - g\ :sub:`1`
 227       - g\ :sub:`0`
 228       - b\ :sub:`4`
 229       - b\ :sub:`3`
 230       - b\ :sub:`2`
 231       - b\ :sub:`1`
 232       - b\ :sub:`0`
 233       -
 234     * .. _V4L2-PIX-FMT-XRGB555X:
 235
 236       - ``V4L2_PIX_FMT_XRGB555X``
 237       - 'XR15' | (1 << 31)
 238
 239       -
 240       - r\ :sub:`4`
 241       - r\ :sub:`3`
 242       - r\ :sub:`2`
 243       - r\ :sub:`1`
 244       - r\ :sub:`0`
 245       - g\ :sub:`4`
 246       - g\ :sub:`3`
 247
 248       - g\ :sub:`2`
 249       - g\ :sub:`1`
 250       - g\ :sub:`0`
 251       - b\ :sub:`4`
 252       - b\ :sub:`3`
 253       - b\ :sub:`2`
 254       - b\ :sub:`1`
 255       - b\ :sub:`0`
 256       -
 257     * .. _V4L2-PIX-FMT-RGB565X:
 258
 259       - ``V4L2_PIX_FMT_RGB565X``
 260       - 'RGBR'
 261
 262       - r\ :sub:`4`
 263       - r\ :sub:`3`
 264       - r\ :sub:`2`
 265       - r\ :sub:`1`
 266       - r\ :sub:`0`
 267       - g\ :sub:`5`
 268       - g\ :sub:`4`
 269       - g\ :sub:`3`
 270
 271       - g\ :sub:`2`
 272       - g\ :sub:`1`
 273       - g\ :sub:`0`
 274       - b\ :sub:`4`
 275       - b\ :sub:`3`
 276       - b\ :sub:`2`
 277       - b\ :sub:`1`
 278       - b\ :sub:`0`
 279       -
 280     * .. _V4L2-PIX-FMT-BGR24:
 281
 282       - ``V4L2_PIX_FMT_BGR24``
 283       - 'BGR3'
 284
 285       - b\ :sub:`7`
 286       - b\ :sub:`6`
 287       - b\ :sub:`5`
 288       - b\ :sub:`4`
 289       - b\ :sub:`3`
 290       - b\ :sub:`2`
 291       - b\ :sub:`1`
 292       - b\ :sub:`0`
 293
 294       - g\ :sub:`7`
 295       - g\ :sub:`6`
 296       - g\ :sub:`5`
 297       - g\ :sub:`4`
 298       - g\ :sub:`3`
 299       - g\ :sub:`2`
 300       - g\ :sub:`1`
 301       - g\ :sub:`0`
 302
 303       - r\ :sub:`7`
 304       - r\ :sub:`6`
 305       - r\ :sub:`5`
 306       - r\ :sub:`4`
 307       - r\ :sub:`3`
 308       - r\ :sub:`2`
 309       - r\ :sub:`1`
 310       - r\ :sub:`0`
 311       -
 312     * .. _V4L2-PIX-FMT-RGB24:
 313
 314       - ``V4L2_PIX_FMT_RGB24``
 315       - 'RGB3'
 316
 317       - r\ :sub:`7`
 318       - r\ :sub:`6`
 319       - r\ :sub:`5`
 320       - r\ :sub:`4`
 321       - r\ :sub:`3`
 322       - r\ :sub:`2`
 323       - r\ :sub:`1`
 324       - r\ :sub:`0`
 325
 326       - g\ :sub:`7`
 327       - g\ :sub:`6`
 328       - g\ :sub:`5`
 329       - g\ :sub:`4`
 330       - g\ :sub:`3`
 331       - g\ :sub:`2`
 332       - g\ :sub:`1`
 333       - g\ :sub:`0`
 334
 335       - b\ :sub:`7`
 336       - b\ :sub:`6`
 337       - b\ :sub:`5`
 338       - b\ :sub:`4`
 339       - b\ :sub:`3`
 340       - b\ :sub:`2`
 341       - b\ :sub:`1`
 342       - b\ :sub:`0`
 343       -
 344     * .. _V4L2-PIX-FMT-BGR666:
 345
 346       - ``V4L2_PIX_FMT_BGR666``
 347       - 'BGRH'
 348
 349       - b\ :sub:`5`
 350       - b\ :sub:`4`
 351       - b\ :sub:`3`
 352       - b\ :sub:`2`
 353       - b\ :sub:`1`
 354       - b\ :sub:`0`
 355       - g\ :sub:`5`
 356       - g\ :sub:`4`
 357
 358       - g\ :sub:`3`
 359       - g\ :sub:`2`
 360       - g\ :sub:`1`
 361       - g\ :sub:`0`
 362       - r\ :sub:`5`
 363       - r\ :sub:`4`
 364       - r\ :sub:`3`
 365       - r\ :sub:`2`
 366
 367       - r\ :sub:`1`
 368       - r\ :sub:`0`
 369       -
 370       -
 371       -
 372       -
 373       -
 374       -
 375
 376       -
 377       -
 378       -
 379       -
 380       -
 381       -
 382       -
 383       -
 384     * .. _V4L2-PIX-FMT-ABGR32:
 385
 386       - ``V4L2_PIX_FMT_ABGR32``
 387       - 'AR24'
 388
 389       - b\ :sub:`7`
 390       - b\ :sub:`6`
 391       - b\ :sub:`5`
 392       - b\ :sub:`4`
 393       - b\ :sub:`3`
 394       - b\ :sub:`2`
 395       - b\ :sub:`1`
 396       - b\ :sub:`0`
 397
 398       - g\ :sub:`7`
 399       - g\ :sub:`6`
 400       - g\ :sub:`5`
 401       - g\ :sub:`4`
 402       - g\ :sub:`3`
 403       - g\ :sub:`2`
 404       - g\ :sub:`1`
 405       - g\ :sub:`0`
 406
 407       - r\ :sub:`7`
 408       - r\ :sub:`6`
 409       - r\ :sub:`5`
 410       - r\ :sub:`4`
 411       - r\ :sub:`3`
 412       - r\ :sub:`2`
 413       - r\ :sub:`1`
 414       - r\ :sub:`0`
 415
 416       - a\ :sub:`7`
 417       - a\ :sub:`6`
 418       - a\ :sub:`5`
 419       - a\ :sub:`4`
 420       - a\ :sub:`3`
 421       - a\ :sub:`2`
 422       - a\ :sub:`1`
 423       - a\ :sub:`0`
 424     * .. _V4L2-PIX-FMT-XBGR32:
 425
 426       - ``V4L2_PIX_FMT_XBGR32``
 427       - 'XR24'
 428
 429       - b\ :sub:`7`
 430       - b\ :sub:`6`
 431       - b\ :sub:`5`
 432       - b\ :sub:`4`
 433       - b\ :sub:`3`
 434       - b\ :sub:`2`
 435       - b\ :sub:`1`
 436       - b\ :sub:`0`
 437
 438       - g\ :sub:`7`
 439       - g\ :sub:`6`
 440       - g\ :sub:`5`
 441       - g\ :sub:`4`
 442       - g\ :sub:`3`
 443       - g\ :sub:`2`
 444       - g\ :sub:`1`
 445       - g\ :sub:`0`
 446
 447       - r\ :sub:`7`
 448       - r\ :sub:`6`
 449       - r\ :sub:`5`
 450       - r\ :sub:`4`
 451       - r\ :sub:`3`
 452       - r\ :sub:`2`
 453       - r\ :sub:`1`
 454       - r\ :sub:`0`
 455
 456       -
 457       -
 458       -
 459       -
 460       -
 461       -
 462       -
 463       -
 464     * .. _V4L2-PIX-FMT-ARGB32:
 465
 466       - ``V4L2_PIX_FMT_ARGB32``
 467       - 'BA24'
 468
 469       - a\ :sub:`7`
 470       - a\ :sub:`6`
 471       - a\ :sub:`5`
 472       - a\ :sub:`4`
 473       - a\ :sub:`3`
 474       - a\ :sub:`2`
 475       - a\ :sub:`1`
 476       - a\ :sub:`0`
 477
 478       - r\ :sub:`7`
 479       - r\ :sub:`6`
 480       - r\ :sub:`5`
 481       - r\ :sub:`4`
 482       - r\ :sub:`3`
 483       - r\ :sub:`2`
 484       - r\ :sub:`1`
 485       - r\ :sub:`0`
 486
 487       - g\ :sub:`7`
 488       - g\ :sub:`6`
 489       - g\ :sub:`5`
 490       - g\ :sub:`4`
 491       - g\ :sub:`3`
 492       - g\ :sub:`2`
 493       - g\ :sub:`1`
 494       - g\ :sub:`0`
 495
 496       - b\ :sub:`7`
 497       - b\ :sub:`6`
 498       - b\ :sub:`5`
 499       - b\ :sub:`4`
 500       - b\ :sub:`3`
 501       - b\ :sub:`2`
 502       - b\ :sub:`1`
 503       - b\ :sub:`0`
 504     * .. _V4L2-PIX-FMT-XRGB32:
 505
 506       - ``V4L2_PIX_FMT_XRGB32``
 507       - 'BX24'
 508
 509       -
 510       -
 511       -
 512       -
 513       -
 514       -
 515       -
 516       -
 517
 518       - r\ :sub:`7`
 519       - r\ :sub:`6`
 520       - r\ :sub:`5`
 521       - r\ :sub:`4`
 522       - r\ :sub:`3`
 523       - r\ :sub:`2`
 524       - r\ :sub:`1`
 525       - r\ :sub:`0`
 526
 527       - g\ :sub:`7`
 528       - g\ :sub:`6`
 529       - g\ :sub:`5`
 530       - g\ :sub:`4`
 531       - g\ :sub:`3`
 532       - g\ :sub:`2`
 533       - g\ :sub:`1`
 534       - g\ :sub:`0`
 535
 536       - b\ :sub:`7`
 537       - b\ :sub:`6`
 538       - b\ :sub:`5`
 539       - b\ :sub:`4`
 540       - b\ :sub:`3`
 541       - b\ :sub:`2`
 542       - b\ :sub:`1`
 543       - b\ :sub:`0`
 544
 545 .. raw:: latex
 546
 547     \endgroup
 548
 549 .. note:: Bit 7 is the most significant bit.
 550
 551 The usage and value of the alpha bits (a) in the ARGB and ABGR formats
 552 (collectively referred to as alpha formats) depend on the device type
 553 and hardware operation. :ref:`Capture <capture>` devices (including
 554 capture queues of mem-to-mem devices) fill the alpha component in
 555 memory. When the device outputs an alpha channel the alpha component
 556 will have a meaningful value. Otherwise, when the device doesn't output
 557 an alpha channel but can set the alpha bit to a user-configurable value,
 558 the :ref:`V4L2_CID_ALPHA_COMPONENT <v4l2-alpha-component>` control
 559 is used to specify that alpha value, and the alpha component of all
 560 pixels will be set to the value specified by that control. Otherwise a
 561 corresponding format without an alpha component (XRGB or XBGR) must be
 562 used instead of an alpha format.
 563
 564 :ref:`Output <output>` devices (including output queues of mem-to-mem
 565 devices and :ref:`video output overlay <osd>` devices) read the alpha
 566 component from memory. When the device processes the alpha channel the
 567 alpha component must be filled with meaningful values by applications.
 568 Otherwise a corresponding format without an alpha component (XRGB or
 569 XBGR) must be used instead of an alpha format.
 570
 571 The XRGB and XBGR formats contain undefined bits (-). Applications,
 572 devices and drivers must ignore those bits, for both
 573 :ref:`capture` and :ref:`output` devices.
 574
 575 **Byte Order.**
 576 Each cell is one byte.
 577
 578
 579 .. raw:: latex
 580
 581     \small
 582
 583 .. tabularcolumns:: |p{3.1cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|p{0.8cm}|
 584
 585 .. flat-table:: RGB byte order
 586     :header-rows:  0
 587     :stub-columns: 0
 588     :widths:       11 3 3 3 3 3 3 3 3 3 3 3 3
 589
 590     * - start + 0:
 591       - B\ :sub:`00`
 592       - G\ :sub:`00`
 593       - R\ :sub:`00`
 594       - B\ :sub:`01`
 595       - G\ :sub:`01`
 596       - R\ :sub:`01`
 597       - B\ :sub:`02`
 598       - G\ :sub:`02`
 599       - R\ :sub:`02`
 600       - B\ :sub:`03`
 601       - G\ :sub:`03`
 602       - R\ :sub:`03`
 603     * - start + 12:
 604       - B\ :sub:`10`
 605       - G\ :sub:`10`
 606       - R\ :sub:`10`
 607       - B\ :sub:`11`
 608       - G\ :sub:`11`
 609       - R\ :sub:`11`
 610       - B\ :sub:`12`
 611       - G\ :sub:`12`
 612       - R\ :sub:`12`
 613       - B\ :sub:`13`
 614       - G\ :sub:`13`
 615       - R\ :sub:`13`
 616     * - start + 24:
 617       - B\ :sub:`20`
 618       - G\ :sub:`20`
 619       - R\ :sub:`20`
 620       - B\ :sub:`21`
 621       - G\ :sub:`21`
 622       - R\ :sub:`21`
 623       - B\ :sub:`22`
 624       - G\ :sub:`22`
 625       - R\ :sub:`22`
 626       - B\ :sub:`23`
 627       - G\ :sub:`23`
 628       - R\ :sub:`23`
 629     * - start + 36:
 630       - B\ :sub:`30`
 631       - G\ :sub:`30`
 632       - R\ :sub:`30`
 633       - B\ :sub:`31`
 634       - G\ :sub:`31`
 635       - R\ :sub:`31`
 636       - B\ :sub:`32`
 637       - G\ :sub:`32`
 638       - R\ :sub:`32`
 639       - B\ :sub:`33`
 640       - G\ :sub:`33`
 641       - R\ :sub:`33`
 642
 643 .. raw:: latex
 644
 645     \normalsize
 646
 647 Formats defined in :ref:`rgb-formats-deprecated` are deprecated and
 648 must not be used by new drivers. They are documented here for reference.
 649 The meaning of their alpha bits ``(a)`` are ill-defined and interpreted as in
 650 either the corresponding ARGB or XRGB format, depending on the driver.
 651
 652
 653 .. raw:: latex
 654
 655     \begingroup
 656     \tiny
 657     \setlength{\tabcolsep}{2pt}
 658
 659 .. tabularcolumns:: |p{2.2cm}|p{0.60cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|
 660
 661 .. _rgb-formats-deprecated:
 662
 663 .. flat-table:: Deprecated Packed RGB Image Formats
 664     :header-rows:  2
 665     :stub-columns: 0
 666
 667     * - Identifier
 668       - Code
 669       - :cspan:`7` Byte 0 in memory
 670
 671       - :cspan:`7` Byte 1
 672
 673       - :cspan:`7` Byte 2
 674
 675       - :cspan:`7` Byte 3
 676     * -
 677       -
 678       - 7
 679       - 6
 680       - 5
 681       - 4
 682       - 3
 683       - 2
 684       - 1
 685       - 0
 686
 687       - 7
 688       - 6
 689       - 5
 690       - 4
 691       - 3
 692       - 2
 693       - 1
 694       - 0
 695
 696       - 7
 697       - 6
 698       - 5
 699       - 4
 700       - 3
 701       - 2
 702       - 1
 703       - 0
 704
 705       - 7
 706       - 6
 707       - 5
 708       - 4
 709       - 3
 710       - 2
 711       - 1
 712       - 0
 713     * .. _V4L2-PIX-FMT-RGB444:
 714
 715       - ``V4L2_PIX_FMT_RGB444``
 716       - 'R444'
 717
 718       - g\ :sub:`3`
 719       - g\ :sub:`2`
 720       - g\ :sub:`1`
 721       - g\ :sub:`0`
 722       - b\ :sub:`3`
 723       - b\ :sub:`2`
 724       - b\ :sub:`1`
 725       - b\ :sub:`0`
 726
 727       - a\ :sub:`3`
 728       - a\ :sub:`2`
 729       - a\ :sub:`1`
 730       - a\ :sub:`0`
 731       - r\ :sub:`3`
 732       - r\ :sub:`2`
 733       - r\ :sub:`1`
 734       - r\ :sub:`0`
 735       -
 736     * .. _V4L2-PIX-FMT-RGB555:
 737
 738       - ``V4L2_PIX_FMT_RGB555``
 739       - 'RGBO'
 740
 741       - g\ :sub:`2`
 742       - g\ :sub:`1`
 743       - g\ :sub:`0`
 744       - b\ :sub:`4`
 745       - b\ :sub:`3`
 746       - b\ :sub:`2`
 747       - b\ :sub:`1`
 748       - b\ :sub:`0`
 749
 750       - a
 751       - r\ :sub:`4`
 752       - r\ :sub:`3`
 753       - r\ :sub:`2`
 754       - r\ :sub:`1`
 755       - r\ :sub:`0`
 756       - g\ :sub:`4`
 757       - g\ :sub:`3`
 758       -
 759     * .. _V4L2-PIX-FMT-RGB555X:
 760
 761       - ``V4L2_PIX_FMT_RGB555X``
 762       - 'RGBQ'
 763
 764       - a
 765       - r\ :sub:`4`
 766       - r\ :sub:`3`
 767       - r\ :sub:`2`
 768       - r\ :sub:`1`
 769       - r\ :sub:`0`
 770       - g\ :sub:`4`
 771       - g\ :sub:`3`
 772
 773       - g\ :sub:`2`
 774       - g\ :sub:`1`
 775       - g\ :sub:`0`
 776       - b\ :sub:`4`
 777       - b\ :sub:`3`
 778       - b\ :sub:`2`
 779       - b\ :sub:`1`
 780       - b\ :sub:`0`
 781       -
 782     * .. _V4L2-PIX-FMT-BGR32:
 783
 784       - ``V4L2_PIX_FMT_BGR32``
 785       - 'BGR4'
 786
 787       - b\ :sub:`7`
 788       - b\ :sub:`6`
 789       - b\ :sub:`5`
 790       - b\ :sub:`4`
 791       - b\ :sub:`3`
 792       - b\ :sub:`2`
 793       - b\ :sub:`1`
 794       - b\ :sub:`0`
 795
 796       - g\ :sub:`7`
 797       - g\ :sub:`6`
 798       - g\ :sub:`5`
 799       - g\ :sub:`4`
 800       - g\ :sub:`3`
 801       - g\ :sub:`2`
 802       - g\ :sub:`1`
 803       - g\ :sub:`0`
 804
 805       - r\ :sub:`7`
 806       - r\ :sub:`6`
 807       - r\ :sub:`5`
 808       - r\ :sub:`4`
 809       - r\ :sub:`3`
 810       - r\ :sub:`2`
 811       - r\ :sub:`1`
 812       - r\ :sub:`0`
 813
 814       - a\ :sub:`7`
 815       - a\ :sub:`6`
 816       - a\ :sub:`5`
 817       - a\ :sub:`4`
 818       - a\ :sub:`3`
 819       - a\ :sub:`2`
 820       - a\ :sub:`1`
 821       - a\ :sub:`0`
 822     * .. _V4L2-PIX-FMT-RGB32:
 823
 824       - ``V4L2_PIX_FMT_RGB32``
 825       - 'RGB4'
 826
 827       - a\ :sub:`7`
 828       - a\ :sub:`6`
 829       - a\ :sub:`5`
 830       - a\ :sub:`4`
 831       - a\ :sub:`3`
 832       - a\ :sub:`2`
 833       - a\ :sub:`1`
 834       - a\ :sub:`0`
 835
 836       - r\ :sub:`7`
 837       - r\ :sub:`6`
 838       - r\ :sub:`5`
 839       - r\ :sub:`4`
 840       - r\ :sub:`3`
 841       - r\ :sub:`2`
 842       - r\ :sub:`1`
 843       - r\ :sub:`0`
 844
 845       - g\ :sub:`7`
 846       - g\ :sub:`6`
 847       - g\ :sub:`5`
 848       - g\ :sub:`4`
 849       - g\ :sub:`3`
 850       - g\ :sub:`2`
 851       - g\ :sub:`1`
 852       - g\ :sub:`0`
 853
 854       - b\ :sub:`7`
 855       - b\ :sub:`6`
 856       - b\ :sub:`5`
 857       - b\ :sub:`4`
 858       - b\ :sub:`3`
 859       - b\ :sub:`2`
 860       - b\ :sub:`1`
 861       - b\ :sub:`0`
 862
 863 .. raw:: latex
 864
 865     \endgroup
 866
 867 A test utility to determine which RGB formats a driver actually supports
 868 is available from the LinuxTV v4l-dvb repository. See
 869 `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
 870 instructions.