Documentation/userspace-api/media/v4l/pixfmt-rgb.rst

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   2
   3 .. _pixfmt-rgb:
   4
   5 ***********
   6 RGB Formats
   7 ***********
   8
   9 These formats encode each pixel as a triplet of RGB values. They are packed
  10 formats, meaning that the RGB values for one pixel are stored consecutively in
  11 memory and each pixel consumes an integer number of bytes. When the number of
  12 bits required to store a pixel is not aligned to a byte boundary, the data is
  13 padded with additional bits to fill the remaining byte.
  14
  15 The formats differ by the number of bits per RGB component (typically but not
  16 always the same for all components), the order of components in memory, and the
  17 presence of an alpha component or additional padding bits.
  18
  19 The usage and value of the alpha bits in formats that support them (named ARGB
  20 or a permutation thereof, collectively referred to as alpha formats) depend on
  21 the device type and hardware operation. :ref:`Capture <capture>` devices
  22 (including capture queues of mem-to-mem devices) fill the alpha component in
  23 memory. When the device captures an alpha channel the alpha component will have
  24 a meaningful value. Otherwise, when the device doesn't capture an alpha channel
  25 but can set the alpha bit to a user-configurable value, the
  26 :ref:`V4L2_CID_ALPHA_COMPONENT <v4l2-alpha-component>` control is used to
  27 specify that alpha value, and the alpha component of all pixels will be set to
  28 the value specified by that control. Otherwise a corresponding format without
  29 an alpha component (XRGB or XBGR) must be used instead of an alpha format.
  30
  31 :ref:`Output <output>` devices (including output queues of mem-to-mem devices
  32 and :ref:`video output overlay <osd>` devices) read the alpha component from
  33 memory. When the device processes the alpha channel the alpha component must be
  34 filled with meaningful values by applications. Otherwise a corresponding format
  35 without an alpha component (XRGB or XBGR) must be used instead of an alpha
  36 format.
  37
  38 Formats that contain padding bits are named XRGB (or a permutation thereof).
  39 The padding bits contain undefined values and must be ignored by applications,
  40 devices and drivers, for both :ref:`capture` and :ref:`output` devices.
  41
  42 .. note::
  43
  44    - In all the tables that follow, bit 7 is the most significant bit in a byte.
  45    - 'r', 'g' and 'b' denote bits of the red, green and blue components
  46      respectively. 'a' denotes bits of the alpha component (if supported by the
  47      format), and 'x' denotes padding bits.
  48
  49
  50 Less Than 8 Bits Per Component
  51 ==============================
  52
  53 These formats store an RGB triplet in one, two or four bytes. They are named
  54 based on the order of the RGB components as seen in a 8-, 16- or 32-bit word,
  55 which is then stored in memory in little endian byte order (unless otherwise
  56 noted by the presence of bit 31 in the 4CC value), and on the number of bits
  57 for each component. For instance, the RGB565 format stores a pixel in a 16-bit
  58 word [15:0] laid out at as [R\ :sub:`4` R\ :sub:`3` R\ :sub:`2` R\ :sub:`1`
  59 R\ :sub:`0` G\ :sub:`5` G\ :sub:`4` G\ :sub:`3` G\ :sub:`2` G\ :sub:`1`
  60 G\ :sub:`0` B\ :sub:`4` B\ :sub:`3` B\ :sub:`2` B\ :sub:`1` B\ :sub:`0`], and
  61 stored in memory in two bytes, [R\ :sub:`4` R\ :sub:`3` R\ :sub:`2` R\ :sub:`1`
  62 R\ :sub:`0` G\ :sub:`5` G\ :sub:`4` G\ :sub:`3`] followed by [G\ :sub:`2`
  63 G\ :sub:`1` G\ :sub:`0` B\ :sub:`4` B\ :sub:`3` B\ :sub:`2` B\ :sub:`1`
  64 B\ :sub:`0`].
  65
  66 .. raw:: latex
  67
  68     \begingroup
  69     \tiny
  70     \setlength{\tabcolsep}{2pt}
  71
  72 .. tabularcolumns:: |p{2.8cm}|p{2.0cm}|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}|
  73
  74
  75 .. flat-table:: RGB Formats With Less Than 8 Bits Per Component
  76     :header-rows:  2
  77     :stub-columns: 0
  78
  79     * - Identifier
  80       - Code
  81       - :cspan:`7` Byte 0 in memory
  82       - :cspan:`7` Byte 1
  83       - :cspan:`7` Byte 2
  84       - :cspan:`7` Byte 3
  85     * -
  86       -
  87       - 7
  88       - 6
  89       - 5
  90       - 4
  91       - 3
  92       - 2
  93       - 1
  94       - 0
  95
  96       - 7
  97       - 6
  98       - 5
  99       - 4
 100       - 3
 101       - 2
 102       - 1
 103       - 0
 104
 105       - 7
 106       - 6
 107       - 5
 108       - 4
 109       - 3
 110       - 2
 111       - 1
 112       - 0
 113
 114       - 7
 115       - 6
 116       - 5
 117       - 4
 118       - 3
 119       - 2
 120       - 1
 121       - 0
 122     * .. _V4L2-PIX-FMT-RGB332:
 123
 124       - ``V4L2_PIX_FMT_RGB332``
 125       - 'RGB1'
 126
 127       - r\ :sub:`2`
 128       - r\ :sub:`1`
 129       - r\ :sub:`0`
 130       - g\ :sub:`2`
 131       - g\ :sub:`1`
 132       - g\ :sub:`0`
 133       - b\ :sub:`1`
 134       - b\ :sub:`0`
 135       -
 136     * .. _V4L2-PIX-FMT-ARGB444:
 137
 138       - ``V4L2_PIX_FMT_ARGB444``
 139       - 'AR12'
 140
 141       - g\ :sub:`3`
 142       - g\ :sub:`2`
 143       - g\ :sub:`1`
 144       - g\ :sub:`0`
 145       - b\ :sub:`3`
 146       - b\ :sub:`2`
 147       - b\ :sub:`1`
 148       - b\ :sub:`0`
 149
 150       - a\ :sub:`3`
 151       - a\ :sub:`2`
 152       - a\ :sub:`1`
 153       - a\ :sub:`0`
 154       - r\ :sub:`3`
 155       - r\ :sub:`2`
 156       - r\ :sub:`1`
 157       - r\ :sub:`0`
 158       -
 159     * .. _V4L2-PIX-FMT-XRGB444:
 160
 161       - ``V4L2_PIX_FMT_XRGB444``
 162       - 'XR12'
 163
 164       - g\ :sub:`3`
 165       - g\ :sub:`2`
 166       - g\ :sub:`1`
 167       - g\ :sub:`0`
 168       - b\ :sub:`3`
 169       - b\ :sub:`2`
 170       - b\ :sub:`1`
 171       - b\ :sub:`0`
 172
 173       - x
 174       - x
 175       - x
 176       - x
 177       - r\ :sub:`3`
 178       - r\ :sub:`2`
 179       - r\ :sub:`1`
 180       - r\ :sub:`0`
 181       -
 182     * .. _V4L2-PIX-FMT-RGBA444:
 183
 184       - ``V4L2_PIX_FMT_RGBA444``
 185       - 'RA12'
 186
 187       - b\ :sub:`3`
 188       - b\ :sub:`2`
 189       - b\ :sub:`1`
 190       - b\ :sub:`0`
 191       - a\ :sub:`3`
 192       - a\ :sub:`2`
 193       - a\ :sub:`1`
 194       - a\ :sub:`0`
 195
 196       - r\ :sub:`3`
 197       - r\ :sub:`2`
 198       - r\ :sub:`1`
 199       - r\ :sub:`0`
 200       - g\ :sub:`3`
 201       - g\ :sub:`2`
 202       - g\ :sub:`1`
 203       - g\ :sub:`0`
 204       -
 205     * .. _V4L2-PIX-FMT-RGBX444:
 206
 207       - ``V4L2_PIX_FMT_RGBX444``
 208       - 'RX12'
 209
 210       - b\ :sub:`3`
 211       - b\ :sub:`2`
 212       - b\ :sub:`1`
 213       - b\ :sub:`0`
 214       - x
 215       - x
 216       - x
 217       - x
 218
 219       - r\ :sub:`3`
 220       - r\ :sub:`2`
 221       - r\ :sub:`1`
 222       - r\ :sub:`0`
 223       - g\ :sub:`3`
 224       - g\ :sub:`2`
 225       - g\ :sub:`1`
 226       - g\ :sub:`0`
 227       -
 228     * .. _V4L2-PIX-FMT-ABGR444:
 229
 230       - ``V4L2_PIX_FMT_ABGR444``
 231       - 'AB12'
 232
 233       - g\ :sub:`3`
 234       - g\ :sub:`2`
 235       - g\ :sub:`1`
 236       - g\ :sub:`0`
 237       - r\ :sub:`3`
 238       - r\ :sub:`2`
 239       - r\ :sub:`1`
 240       - r\ :sub:`0`
 241
 242       - a\ :sub:`3`
 243       - a\ :sub:`2`
 244       - a\ :sub:`1`
 245       - a\ :sub:`0`
 246       - b\ :sub:`3`
 247       - b\ :sub:`2`
 248       - b\ :sub:`1`
 249       - b\ :sub:`0`
 250       -
 251     * .. _V4L2-PIX-FMT-XBGR444:
 252
 253       - ``V4L2_PIX_FMT_XBGR444``
 254       - 'XB12'
 255
 256       - g\ :sub:`3`
 257       - g\ :sub:`2`
 258       - g\ :sub:`1`
 259       - g\ :sub:`0`
 260       - r\ :sub:`3`
 261       - r\ :sub:`2`
 262       - r\ :sub:`1`
 263       - r\ :sub:`0`
 264
 265       - x
 266       - x
 267       - x
 268       - x
 269       - b\ :sub:`3`
 270       - b\ :sub:`2`
 271       - b\ :sub:`1`
 272       - b\ :sub:`0`
 273       -
 274     * .. _V4L2-PIX-FMT-BGRA444:
 275
 276       - ``V4L2_PIX_FMT_BGRA444``
 277       - 'BA12'
 278
 279       - r\ :sub:`3`
 280       - r\ :sub:`2`
 281       - r\ :sub:`1`
 282       - r\ :sub:`0`
 283       - a\ :sub:`3`
 284       - a\ :sub:`2`
 285       - a\ :sub:`1`
 286       - a\ :sub:`0`
 287
 288       - b\ :sub:`3`
 289       - b\ :sub:`2`
 290       - b\ :sub:`1`
 291       - b\ :sub:`0`
 292       - g\ :sub:`3`
 293       - g\ :sub:`2`
 294       - g\ :sub:`1`
 295       - g\ :sub:`0`
 296       -
 297     * .. _V4L2-PIX-FMT-BGRX444:
 298
 299       - ``V4L2_PIX_FMT_BGRX444``
 300       - 'BX12'
 301
 302       - r\ :sub:`3`
 303       - r\ :sub:`2`
 304       - r\ :sub:`1`
 305       - r\ :sub:`0`
 306       - x
 307       - x
 308       - x
 309       - x
 310
 311       - b\ :sub:`3`
 312       - b\ :sub:`2`
 313       - b\ :sub:`1`
 314       - b\ :sub:`0`
 315       - g\ :sub:`3`
 316       - g\ :sub:`2`
 317       - g\ :sub:`1`
 318       - g\ :sub:`0`
 319       -
 320     * .. _V4L2-PIX-FMT-ARGB555:
 321
 322       - ``V4L2_PIX_FMT_ARGB555``
 323       - 'AR15'
 324
 325       - g\ :sub:`2`
 326       - g\ :sub:`1`
 327       - g\ :sub:`0`
 328       - b\ :sub:`4`
 329       - b\ :sub:`3`
 330       - b\ :sub:`2`
 331       - b\ :sub:`1`
 332       - b\ :sub:`0`
 333
 334       - a
 335       - r\ :sub:`4`
 336       - r\ :sub:`3`
 337       - r\ :sub:`2`
 338       - r\ :sub:`1`
 339       - r\ :sub:`0`
 340       - g\ :sub:`4`
 341       - g\ :sub:`3`
 342       -
 343     * .. _V4L2-PIX-FMT-XRGB555:
 344
 345       - ``V4L2_PIX_FMT_XRGB555``
 346       - 'XR15'
 347
 348       - g\ :sub:`2`
 349       - g\ :sub:`1`
 350       - g\ :sub:`0`
 351       - b\ :sub:`4`
 352       - b\ :sub:`3`
 353       - b\ :sub:`2`
 354       - b\ :sub:`1`
 355       - b\ :sub:`0`
 356
 357       - x
 358       - r\ :sub:`4`
 359       - r\ :sub:`3`
 360       - r\ :sub:`2`
 361       - r\ :sub:`1`
 362       - r\ :sub:`0`
 363       - g\ :sub:`4`
 364       - g\ :sub:`3`
 365       -
 366     * .. _V4L2-PIX-FMT-RGBA555:
 367
 368       - ``V4L2_PIX_FMT_RGBA555``
 369       - 'RA15'
 370
 371       - g\ :sub:`1`
 372       - g\ :sub:`0`
 373       - b\ :sub:`4`
 374       - b\ :sub:`3`
 375       - b\ :sub:`2`
 376       - b\ :sub:`1`
 377       - b\ :sub:`0`
 378       - a
 379
 380       - r\ :sub:`4`
 381       - r\ :sub:`3`
 382       - r\ :sub:`2`
 383       - r\ :sub:`1`
 384       - r\ :sub:`0`
 385       - g\ :sub:`4`
 386       - g\ :sub:`3`
 387       - g\ :sub:`2`
 388       -
 389     * .. _V4L2-PIX-FMT-RGBX555:
 390
 391       - ``V4L2_PIX_FMT_RGBX555``
 392       - 'RX15'
 393
 394       - g\ :sub:`1`
 395       - g\ :sub:`0`
 396       - b\ :sub:`4`
 397       - b\ :sub:`3`
 398       - b\ :sub:`2`
 399       - b\ :sub:`1`
 400       - b\ :sub:`0`
 401       - x
 402
 403       - r\ :sub:`4`
 404       - r\ :sub:`3`
 405       - r\ :sub:`2`
 406       - r\ :sub:`1`
 407       - r\ :sub:`0`
 408       - g\ :sub:`4`
 409       - g\ :sub:`3`
 410       - g\ :sub:`2`
 411       -
 412     * .. _V4L2-PIX-FMT-ABGR555:
 413
 414       - ``V4L2_PIX_FMT_ABGR555``
 415       - 'AB15'
 416
 417       - g\ :sub:`2`
 418       - g\ :sub:`1`
 419       - g\ :sub:`0`
 420       - r\ :sub:`4`
 421       - r\ :sub:`3`
 422       - r\ :sub:`2`
 423       - r\ :sub:`1`
 424       - r\ :sub:`0`
 425
 426       - a
 427       - b\ :sub:`4`
 428       - b\ :sub:`3`
 429       - b\ :sub:`2`
 430       - b\ :sub:`1`
 431       - b\ :sub:`0`
 432       - g\ :sub:`4`
 433       - g\ :sub:`3`
 434       -
 435     * .. _V4L2-PIX-FMT-XBGR555:
 436
 437       - ``V4L2_PIX_FMT_XBGR555``
 438       - 'XB15'
 439
 440       - g\ :sub:`2`
 441       - g\ :sub:`1`
 442       - g\ :sub:`0`
 443       - r\ :sub:`4`
 444       - r\ :sub:`3`
 445       - r\ :sub:`2`
 446       - r\ :sub:`1`
 447       - r\ :sub:`0`
 448
 449       - x
 450       - b\ :sub:`4`
 451       - b\ :sub:`3`
 452       - b\ :sub:`2`
 453       - b\ :sub:`1`
 454       - b\ :sub:`0`
 455       - g\ :sub:`4`
 456       - g\ :sub:`3`
 457       -
 458     * .. _V4L2-PIX-FMT-BGRA555:
 459
 460       - ``V4L2_PIX_FMT_BGRA555``
 461       - 'BA15'
 462
 463       - g\ :sub:`1`
 464       - g\ :sub:`0`
 465       - r\ :sub:`4`
 466       - r\ :sub:`3`
 467       - r\ :sub:`2`
 468       - r\ :sub:`1`
 469       - r\ :sub:`0`
 470       - a
 471
 472       - b\ :sub:`4`
 473       - b\ :sub:`3`
 474       - b\ :sub:`2`
 475       - b\ :sub:`1`
 476       - b\ :sub:`0`
 477       - g\ :sub:`4`
 478       - g\ :sub:`3`
 479       - g\ :sub:`2`
 480       -
 481     * .. _V4L2-PIX-FMT-BGRX555:
 482
 483       - ``V4L2_PIX_FMT_BGRX555``
 484       - 'BX15'
 485
 486       - g\ :sub:`1`
 487       - g\ :sub:`0`
 488       - r\ :sub:`4`
 489       - r\ :sub:`3`
 490       - r\ :sub:`2`
 491       - r\ :sub:`1`
 492       - r\ :sub:`0`
 493       - x
 494
 495       - b\ :sub:`4`
 496       - b\ :sub:`3`
 497       - b\ :sub:`2`
 498       - b\ :sub:`1`
 499       - b\ :sub:`0`
 500       - g\ :sub:`4`
 501       - g\ :sub:`3`
 502       - g\ :sub:`2`
 503       -
 504     * .. _V4L2-PIX-FMT-RGB565:
 505
 506       - ``V4L2_PIX_FMT_RGB565``
 507       - 'RGBP'
 508
 509       - g\ :sub:`2`
 510       - g\ :sub:`1`
 511       - g\ :sub:`0`
 512       - b\ :sub:`4`
 513       - b\ :sub:`3`
 514       - b\ :sub:`2`
 515       - b\ :sub:`1`
 516       - b\ :sub:`0`
 517
 518       - r\ :sub:`4`
 519       - r\ :sub:`3`
 520       - r\ :sub:`2`
 521       - r\ :sub:`1`
 522       - r\ :sub:`0`
 523       - g\ :sub:`5`
 524       - g\ :sub:`4`
 525       - g\ :sub:`3`
 526       -
 527     * .. _V4L2-PIX-FMT-ARGB555X:
 528
 529       - ``V4L2_PIX_FMT_ARGB555X``
 530       - 'AR15' | (1 << 31)
 531
 532       - a
 533       - r\ :sub:`4`
 534       - r\ :sub:`3`
 535       - r\ :sub:`2`
 536       - r\ :sub:`1`
 537       - r\ :sub:`0`
 538       - g\ :sub:`4`
 539       - g\ :sub:`3`
 540
 541       - g\ :sub:`2`
 542       - g\ :sub:`1`
 543       - g\ :sub:`0`
 544       - b\ :sub:`4`
 545       - b\ :sub:`3`
 546       - b\ :sub:`2`
 547       - b\ :sub:`1`
 548       - b\ :sub:`0`
 549       -
 550     * .. _V4L2-PIX-FMT-XRGB555X:
 551
 552       - ``V4L2_PIX_FMT_XRGB555X``
 553       - 'XR15' | (1 << 31)
 554
 555       - x
 556       - r\ :sub:`4`
 557       - r\ :sub:`3`
 558       - r\ :sub:`2`
 559       - r\ :sub:`1`
 560       - r\ :sub:`0`
 561       - g\ :sub:`4`
 562       - g\ :sub:`3`
 563
 564       - g\ :sub:`2`
 565       - g\ :sub:`1`
 566       - g\ :sub:`0`
 567       - b\ :sub:`4`
 568       - b\ :sub:`3`
 569       - b\ :sub:`2`
 570       - b\ :sub:`1`
 571       - b\ :sub:`0`
 572       -
 573     * .. _V4L2-PIX-FMT-RGB565X:
 574
 575       - ``V4L2_PIX_FMT_RGB565X``
 576       - 'RGBR'
 577
 578       - r\ :sub:`4`
 579       - r\ :sub:`3`
 580       - r\ :sub:`2`
 581       - r\ :sub:`1`
 582       - r\ :sub:`0`
 583       - g\ :sub:`5`
 584       - g\ :sub:`4`
 585       - g\ :sub:`3`
 586
 587       - g\ :sub:`2`
 588       - g\ :sub:`1`
 589       - g\ :sub:`0`
 590       - b\ :sub:`4`
 591       - b\ :sub:`3`
 592       - b\ :sub:`2`
 593       - b\ :sub:`1`
 594       - b\ :sub:`0`
 595       -
 596     * .. _V4L2-PIX-FMT-BGR666:
 597
 598       - ``V4L2_PIX_FMT_BGR666``
 599       - 'BGRH'
 600
 601       - b\ :sub:`5`
 602       - b\ :sub:`4`
 603       - b\ :sub:`3`
 604       - b\ :sub:`2`
 605       - b\ :sub:`1`
 606       - b\ :sub:`0`
 607       - g\ :sub:`5`
 608       - g\ :sub:`4`
 609
 610       - g\ :sub:`3`
 611       - g\ :sub:`2`
 612       - g\ :sub:`1`
 613       - g\ :sub:`0`
 614       - r\ :sub:`5`
 615       - r\ :sub:`4`
 616       - r\ :sub:`3`
 617       - r\ :sub:`2`
 618
 619       - r\ :sub:`1`
 620       - r\ :sub:`0`
 621       - x
 622       - x
 623       - x
 624       - x
 625       - x
 626       - x
 627
 628       - x
 629       - x
 630       - x
 631       - x
 632       - x
 633       - x
 634       - x
 635       - x
 636
 637 .. raw:: latex
 638
 639     \endgroup
 640
 641
 642 8 Bits Per Component
 643 ====================
 644
 645 These formats store an RGB triplet in three or four bytes. They are named based
 646 on the order of the RGB components as stored in memory, and on the total number
 647 of bits per pixel. For instance, RGB24 format stores a pixel with [R\ :sub:`7`
 648 R\ :sub:`6` R\ :sub:`5` R\ :sub:`4` R\ :sub:`3` R\ :sub:`2` R\ :sub:`1`
 649 R\ :sub:`0`] in the first byte, [G\ :sub:`7` G\ :sub:`6` G\ :sub:`5` G\ :sub:`4`
 650 G\ :sub:`3` G\ :sub:`2` G\ :sub:`1` G\ :sub:`0`] in the second byte and
 651 [B\ :sub:`7` B\ :sub:`6` B\ :sub:`5` B\ :sub:`4` B\ :sub:`3` B\ :sub:`2`
 652 B\ :sub:`1` B\ :sub:`0`] in the third byte. This differs from the DRM format
 653 nomenclature that instead use the order of components as seen in a 24- or
 654 32-bit little endian word.
 655
 656 .. raw:: latex
 657
 658     \begingroup
 659     \tiny
 660     \setlength{\tabcolsep}{2pt}
 661
 662 .. tabularcolumns:: |p{2.8cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|
 663
 664
 665 .. flat-table:: RGB Formats With 8 Bits Per Component
 666     :header-rows:  1
 667     :stub-columns: 0
 668
 669     * - Identifier
 670       - Code
 671       - Byte 0 in memory
 672       - Byte 1
 673       - Byte 2
 674       - Byte 3
 675     * .. _V4L2-PIX-FMT-BGR24:
 676
 677       - ``V4L2_PIX_FMT_BGR24``
 678       - 'BGR3'
 679
 680       - G\ :sub:`7-0`
 681       - B\ :sub:`7-0`
 682       - R\ :sub:`7-0`
 683       -
 684     * .. _V4L2-PIX-FMT-RGB24:
 685
 686       - ``V4L2_PIX_FMT_RGB24``
 687       - 'RGB3'
 688
 689       - R\ :sub:`7-0`
 690       - G\ :sub:`7-0`
 691       - B\ :sub:`7-0`
 692       -
 693     * .. _V4L2-PIX-FMT-ABGR32:
 694
 695       - ``V4L2_PIX_FMT_ABGR32``
 696       - 'AR24'
 697
 698       - B\ :sub:`7-0`
 699       - G\ :sub:`7-0`
 700       - R\ :sub:`7-0`
 701       - A\ :sub:`7-0`
 702     * .. _V4L2-PIX-FMT-XBGR32:
 703
 704       - ``V4L2_PIX_FMT_XBGR32``
 705       - 'XR24'
 706
 707       - B\ :sub:`7-0`
 708       - G\ :sub:`7-0`
 709       - R\ :sub:`7-0`
 710       - X\ :sub:`7-0`
 711     * .. _V4L2-PIX-FMT-BGRA32:
 712
 713       - ``V4L2_PIX_FMT_BGRA32``
 714       - 'RA24'
 715
 716       - A\ :sub:`7-0`
 717       - B\ :sub:`7-0`
 718       - G\ :sub:`7-0`
 719       - R\ :sub:`7-0`
 720     * .. _V4L2-PIX-FMT-BGRX32:
 721
 722       - ``V4L2_PIX_FMT_BGRX32``
 723       - 'RX24'
 724
 725       - X\ :sub:`7-0`
 726       - B\ :sub:`7-0`
 727       - G\ :sub:`7-0`
 728       - R\ :sub:`7-0`
 729     * .. _V4L2-PIX-FMT-RGBA32:
 730
 731       - ``V4L2_PIX_FMT_RGBA32``
 732       - 'AB24'
 733
 734       - R\ :sub:`7-0`
 735       - G\ :sub:`7-0`
 736       - B\ :sub:`7-0`
 737       - A\ :sub:`7-0`
 738     * .. _V4L2-PIX-FMT-RGBX32:
 739
 740       - ``V4L2_PIX_FMT_RGBX32``
 741       - 'XB24'
 742
 743       - R\ :sub:`7-0`
 744       - G\ :sub:`7-0`
 745       - B\ :sub:`7-0`
 746       - X\ :sub:`7-0`
 747     * .. _V4L2-PIX-FMT-ARGB32:
 748
 749       - ``V4L2_PIX_FMT_ARGB32``
 750       - 'BA24'
 751
 752       - A\ :sub:`7-0`
 753       - R\ :sub:`7-0`
 754       - G\ :sub:`7-0`
 755       - B\ :sub:`7-0`
 756     * .. _V4L2-PIX-FMT-XRGB32:
 757
 758       - ``V4L2_PIX_FMT_XRGB32``
 759       - 'BX24'
 760
 761       - X\ :sub:`7-0`
 762       - R\ :sub:`7-0`
 763       - G\ :sub:`7-0`
 764       - B\ :sub:`7-0`
 765
 766 .. raw:: latex
 767
 768     \endgroup
 769
 770
 771 Deprecated RGB Formats
 772 ======================
 773
 774 Formats defined in :ref:`pixfmt-rgb-deprecated` are deprecated and must not be
 775 used by new drivers. They are documented here for reference. The meaning of
 776 their alpha bits ``(a)`` is ill-defined and they are interpreted as in either
 777 the corresponding ARGB or XRGB format, depending on the driver.
 778
 779 .. raw:: latex
 780
 781     \begingroup
 782     \tiny
 783     \setlength{\tabcolsep}{2pt}
 784
 785 .. tabularcolumns:: |p{2.6cm}|p{0.70cm}|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}|
 786
 787 .. _pixfmt-rgb-deprecated:
 788
 789 .. flat-table:: Deprecated Packed RGB Image Formats
 790     :header-rows:  2
 791     :stub-columns: 0
 792
 793     * - Identifier
 794       - Code
 795       - :cspan:`7` Byte 0 in memory
 796
 797       - :cspan:`7` Byte 1
 798
 799       - :cspan:`7` Byte 2
 800
 801       - :cspan:`7` Byte 3
 802     * -
 803       -
 804       - 7
 805       - 6
 806       - 5
 807       - 4
 808       - 3
 809       - 2
 810       - 1
 811       - 0
 812
 813       - 7
 814       - 6
 815       - 5
 816       - 4
 817       - 3
 818       - 2
 819       - 1
 820       - 0
 821
 822       - 7
 823       - 6
 824       - 5
 825       - 4
 826       - 3
 827       - 2
 828       - 1
 829       - 0
 830
 831       - 7
 832       - 6
 833       - 5
 834       - 4
 835       - 3
 836       - 2
 837       - 1
 838       - 0
 839     * .. _V4L2-PIX-FMT-RGB444:
 840
 841       - ``V4L2_PIX_FMT_RGB444``
 842       - 'R444'
 843
 844       - g\ :sub:`3`
 845       - g\ :sub:`2`
 846       - g\ :sub:`1`
 847       - g\ :sub:`0`
 848       - b\ :sub:`3`
 849       - b\ :sub:`2`
 850       - b\ :sub:`1`
 851       - b\ :sub:`0`
 852
 853       - a\ :sub:`3`
 854       - a\ :sub:`2`
 855       - a\ :sub:`1`
 856       - a\ :sub:`0`
 857       - r\ :sub:`3`
 858       - r\ :sub:`2`
 859       - r\ :sub:`1`
 860       - r\ :sub:`0`
 861       -
 862     * .. _V4L2-PIX-FMT-RGB555:
 863
 864       - ``V4L2_PIX_FMT_RGB555``
 865       - 'RGBO'
 866
 867       - g\ :sub:`2`
 868       - g\ :sub:`1`
 869       - g\ :sub:`0`
 870       - b\ :sub:`4`
 871       - b\ :sub:`3`
 872       - b\ :sub:`2`
 873       - b\ :sub:`1`
 874       - b\ :sub:`0`
 875
 876       - a
 877       - r\ :sub:`4`
 878       - r\ :sub:`3`
 879       - r\ :sub:`2`
 880       - r\ :sub:`1`
 881       - r\ :sub:`0`
 882       - g\ :sub:`4`
 883       - g\ :sub:`3`
 884       -
 885     * .. _V4L2-PIX-FMT-RGB555X:
 886
 887       - ``V4L2_PIX_FMT_RGB555X``
 888       - 'RGBQ'
 889
 890       - a
 891       - r\ :sub:`4`
 892       - r\ :sub:`3`
 893       - r\ :sub:`2`
 894       - r\ :sub:`1`
 895       - r\ :sub:`0`
 896       - g\ :sub:`4`
 897       - g\ :sub:`3`
 898
 899       - g\ :sub:`2`
 900       - g\ :sub:`1`
 901       - g\ :sub:`0`
 902       - b\ :sub:`4`
 903       - b\ :sub:`3`
 904       - b\ :sub:`2`
 905       - b\ :sub:`1`
 906       - b\ :sub:`0`
 907       -
 908     * .. _V4L2-PIX-FMT-BGR32:
 909
 910       - ``V4L2_PIX_FMT_BGR32``
 911       - 'BGR4'
 912
 913       - b\ :sub:`7`
 914       - b\ :sub:`6`
 915       - b\ :sub:`5`
 916       - b\ :sub:`4`
 917       - b\ :sub:`3`
 918       - b\ :sub:`2`
 919       - b\ :sub:`1`
 920       - b\ :sub:`0`
 921
 922       - g\ :sub:`7`
 923       - g\ :sub:`6`
 924       - g\ :sub:`5`
 925       - g\ :sub:`4`
 926       - g\ :sub:`3`
 927       - g\ :sub:`2`
 928       - g\ :sub:`1`
 929       - g\ :sub:`0`
 930
 931       - r\ :sub:`7`
 932       - r\ :sub:`6`
 933       - r\ :sub:`5`
 934       - r\ :sub:`4`
 935       - r\ :sub:`3`
 936       - r\ :sub:`2`
 937       - r\ :sub:`1`
 938       - r\ :sub:`0`
 939
 940       - a\ :sub:`7`
 941       - a\ :sub:`6`
 942       - a\ :sub:`5`
 943       - a\ :sub:`4`
 944       - a\ :sub:`3`
 945       - a\ :sub:`2`
 946       - a\ :sub:`1`
 947       - a\ :sub:`0`
 948     * .. _V4L2-PIX-FMT-RGB32:
 949
 950       - ``V4L2_PIX_FMT_RGB32``
 951       - 'RGB4'
 952
 953       - a\ :sub:`7`
 954       - a\ :sub:`6`
 955       - a\ :sub:`5`
 956       - a\ :sub:`4`
 957       - a\ :sub:`3`
 958       - a\ :sub:`2`
 959       - a\ :sub:`1`
 960       - a\ :sub:`0`
 961
 962       - r\ :sub:`7`
 963       - r\ :sub:`6`
 964       - r\ :sub:`5`
 965       - r\ :sub:`4`
 966       - r\ :sub:`3`
 967       - r\ :sub:`2`
 968       - r\ :sub:`1`
 969       - r\ :sub:`0`
 970
 971       - g\ :sub:`7`
 972       - g\ :sub:`6`
 973       - g\ :sub:`5`
 974       - g\ :sub:`4`
 975       - g\ :sub:`3`
 976       - g\ :sub:`2`
 977       - g\ :sub:`1`
 978       - g\ :sub:`0`
 979
 980       - b\ :sub:`7`
 981       - b\ :sub:`6`
 982       - b\ :sub:`5`
 983       - b\ :sub:`4`
 984       - b\ :sub:`3`
 985       - b\ :sub:`2`
 986       - b\ :sub:`1`
 987       - b\ :sub:`0`
 988
 989 .. raw:: latex
 990
 991     \endgroup
 992
 993 A test utility to determine which RGB formats a driver actually supports
 994 is available from the LinuxTV v4l-dvb repository. See
 995 `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
 996 instructions.