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 *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
  36        -
  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
  47        -
  48        -
  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
  67        -
  68        -  7
  69
  70        -  6
  71
  72        -  5
  73
  74        -  4
  75
  76        -  3
  77
  78        -  2
  79
  80        -  1
  81
  82        -  0
  83
  84        -
  85        -  7
  86
  87        -  6
  88
  89        -  5
  90
  91        -  4
  92
  93        -  3
  94
  95        -  2
  96
  97        -  1
  98
  99        -  0
 100
 101        -
 102        -  7
 103
 104        -  6
 105
 106        -  5
 107
 108        -  4
 109
 110        -  3
 111
 112        -  2
 113
 114        -  1
 115
 116        -  0
 117
 118     -  .. _V4L2-PIX-FMT-RGB332:
 119
 120        -  ``V4L2_PIX_FMT_RGB332``
 121
 122        -  'RGB1'
 123
 124        -
 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
 141     -  .. _V4L2-PIX-FMT-ARGB444:
 142
 143        -  ``V4L2_PIX_FMT_ARGB444``
 144
 145        -  'AR12'
 146
 147        -
 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
 164        -
 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
 181     -  .. _V4L2-PIX-FMT-XRGB444:
 182
 183        -  ``V4L2_PIX_FMT_XRGB444``
 184
 185        -  'XR12'
 186
 187        -
 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
 204        -
 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
 221     -  .. _V4L2-PIX-FMT-ARGB555:
 222
 223        -  ``V4L2_PIX_FMT_ARGB555``
 224
 225        -  'AR15'
 226
 227        -
 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
 244        -
 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
 261     -  .. _V4L2-PIX-FMT-XRGB555:
 262
 263        -  ``V4L2_PIX_FMT_XRGB555``
 264
 265        -  'XR15'
 266
 267        -
 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
 284        -
 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
 301     -  .. _V4L2-PIX-FMT-RGB565:
 302
 303        -  ``V4L2_PIX_FMT_RGB565``
 304
 305        -  'RGBP'
 306
 307        -
 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
 324        -
 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
 341     -  .. _V4L2-PIX-FMT-ARGB555X:
 342
 343        -  ``V4L2_PIX_FMT_ARGB555X``
 344
 345        -  'AR15' | (1 << 31)
 346
 347        -
 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
 364        -
 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
 381     -  .. _V4L2-PIX-FMT-XRGB555X:
 382
 383        -  ``V4L2_PIX_FMT_XRGB555X``
 384
 385        -  'XR15' | (1 << 31)
 386
 387        -
 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
 404        -
 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
 421     -  .. _V4L2-PIX-FMT-RGB565X:
 422
 423        -  ``V4L2_PIX_FMT_RGB565X``
 424
 425        -  'RGBR'
 426
 427        -
 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
 444        -
 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
 461     -  .. _V4L2-PIX-FMT-BGR24:
 462
 463        -  ``V4L2_PIX_FMT_BGR24``
 464
 465        -  'BGR3'
 466
 467        -
 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
 484        -
 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
 501        -
 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
 518     -  .. _V4L2-PIX-FMT-RGB24:
 519
 520        -  ``V4L2_PIX_FMT_RGB24``
 521
 522        -  'RGB3'
 523
 524        -
 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
 541        -
 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
 558        -
 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
 575     -  .. _V4L2-PIX-FMT-BGR666:
 576
 577        -  ``V4L2_PIX_FMT_BGR666``
 578
 579        -  'BGRH'
 580
 581        -
 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
 598        -
 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
 615        -
 616        -  r\ :sub:`1`
 617
 618        -  r\ :sub:`0`
 619
 620        -  -
 621
 622        -  -
 623
 624        -  -
 625
 626        -  -
 627
 628        -  -
 629
 630        -  -
 631
 632        -
 633        -  -
 634
 635        -  -
 636
 637        -  -
 638
 639        -  -
 640
 641        -  -
 642
 643        -  -
 644
 645        -  -
 646
 647        -  -
 648
 649     -  .. _V4L2-PIX-FMT-ABGR32:
 650
 651        -  ``V4L2_PIX_FMT_ABGR32``
 652
 653        -  'AR24'
 654
 655        -
 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
 672        -
 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
 689        -
 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
 706        -
 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
 723     -  .. _V4L2-PIX-FMT-XBGR32:
 724
 725        -  ``V4L2_PIX_FMT_XBGR32``
 726
 727        -  'XR24'
 728
 729        -
 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
 746        -
 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
 763        -
 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
 780        -
 781        -  -
 782
 783        -  -
 784
 785        -  -
 786
 787        -  -
 788
 789        -  -
 790
 791        -  -
 792
 793        -  -
 794
 795        -  -
 796
 797     -  .. _V4L2-PIX-FMT-ARGB32:
 798
 799        -  ``V4L2_PIX_FMT_ARGB32``
 800
 801        -  'BA24'
 802
 803        -
 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
 820        -
 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
 837        -
 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
 854        -
 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
 871     -  .. _V4L2-PIX-FMT-XRGB32:
 872
 873        -  ``V4L2_PIX_FMT_XRGB32``
 874
 875        -  'BX24'
 876
 877        -
 878        -  -
 879
 880        -  -
 881
 882        -  -
 883
 884        -  -
 885
 886        -  -
 887
 888        -  -
 889
 890        -  -
 891
 892        -  -
 893
 894        -
 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
 911        -
 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
 928        -
 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
 970 :ref:`capture` and :ref:`output` devices.
 971
 972 **Byte Order.**
 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
1115        -
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
1126        -
1127        -
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
1146        -
1147        -  7
1148
1149        -  6
1150
1151        -  5
1152
1153        -  4
1154
1155        -  3
1156
1157        -  2
1158
1159        -  1
1160
1161        -  0
1162
1163        -
1164        -  7
1165
1166        -  6
1167
1168        -  5
1169
1170        -  4
1171
1172        -  3
1173
1174        -  2
1175
1176        -  1
1177
1178        -  0
1179
1180        -
1181        -  7
1182
1183        -  6
1184
1185        -  5
1186
1187        -  4
1188
1189        -  3
1190
1191        -  2
1192
1193        -  1
1194
1195        -  0
1196
1197     -  .. _V4L2-PIX-FMT-RGB444:
1198
1199        -  ``V4L2_PIX_FMT_RGB444``
1200
1201        -  'R444'
1202
1203        -
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
1220        -
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
1237     -  .. _V4L2-PIX-FMT-RGB555:
1238
1239        -  ``V4L2_PIX_FMT_RGB555``
1240
1241        -  'RGBO'
1242
1243        -
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
1260        -
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
1277     -  .. _V4L2-PIX-FMT-RGB555X:
1278
1279        -  ``V4L2_PIX_FMT_RGB555X``
1280
1281        -  'RGBQ'
1282
1283        -
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
1300        -
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
1317     -  .. _V4L2-PIX-FMT-BGR32:
1318
1319        -  ``V4L2_PIX_FMT_BGR32``
1320
1321        -  'BGR4'
1322
1323        -
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
1340        -
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
1357        -
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
1374        -
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
1391     -  .. _V4L2-PIX-FMT-RGB32:
1392
1393        -  ``V4L2_PIX_FMT_RGB32``
1394
1395        -  'RGB4'
1396
1397        -
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
1414        -
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
1431        -
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
1448        -
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.