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