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

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