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
  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     \begin{adjustbox}{width=\columnwidth}
1119
1120 .. 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}|
1121
1122 .. _rgb-formats-deprecated:
1123
1124 .. flat-table:: Deprecated Packed RGB Image Formats
1125     :header-rows:  2
1126     :stub-columns: 0
1127
1128
1129     -  .. row 1
1130
1131        -  Identifier
1132
1133        -  Code
1134
1135        -
1136        -  :cspan:`7` Byte 0 in memory
1137
1138        -
1139        -  :cspan:`7` Byte 1
1140
1141        -
1142        -  :cspan:`7` Byte 2
1143
1144        -
1145        -  :cspan:`7` Byte 3
1146
1147     -  .. row 2
1148
1149        -
1150        -
1151        -  Bit
1152
1153        -  7
1154
1155        -  6
1156
1157        -  5
1158
1159        -  4
1160
1161        -  3
1162
1163        -  2
1164
1165        -  1
1166
1167        -  0
1168
1169        -
1170        -  7
1171
1172        -  6
1173
1174        -  5
1175
1176        -  4
1177
1178        -  3
1179
1180        -  2
1181
1182        -  1
1183
1184        -  0
1185
1186        -
1187        -  7
1188
1189        -  6
1190
1191        -  5
1192
1193        -  4
1194
1195        -  3
1196
1197        -  2
1198
1199        -  1
1200
1201        -  0
1202
1203        -
1204        -  7
1205
1206        -  6
1207
1208        -  5
1209
1210        -  4
1211
1212        -  3
1213
1214        -  2
1215
1216        -  1
1217
1218        -  0
1219
1220     -  .. _V4L2-PIX-FMT-RGB444:
1221
1222        -  ``V4L2_PIX_FMT_RGB444``
1223
1224        -  'R444'
1225
1226        -
1227        -  g\ :sub:`3`
1228
1229        -  g\ :sub:`2`
1230
1231        -  g\ :sub:`1`
1232
1233        -  g\ :sub:`0`
1234
1235        -  b\ :sub:`3`
1236
1237        -  b\ :sub:`2`
1238
1239        -  b\ :sub:`1`
1240
1241        -  b\ :sub:`0`
1242
1243        -
1244        -  a\ :sub:`3`
1245
1246        -  a\ :sub:`2`
1247
1248        -  a\ :sub:`1`
1249
1250        -  a\ :sub:`0`
1251
1252        -  r\ :sub:`3`
1253
1254        -  r\ :sub:`2`
1255
1256        -  r\ :sub:`1`
1257
1258        -  r\ :sub:`0`
1259
1260     -  .. _V4L2-PIX-FMT-RGB555:
1261
1262        -  ``V4L2_PIX_FMT_RGB555``
1263
1264        -  'RGBO'
1265
1266        -
1267        -  g\ :sub:`2`
1268
1269        -  g\ :sub:`1`
1270
1271        -  g\ :sub:`0`
1272
1273        -  b\ :sub:`4`
1274
1275        -  b\ :sub:`3`
1276
1277        -  b\ :sub:`2`
1278
1279        -  b\ :sub:`1`
1280
1281        -  b\ :sub:`0`
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     -  .. _V4L2-PIX-FMT-RGB555X:
1301
1302        -  ``V4L2_PIX_FMT_RGB555X``
1303
1304        -  'RGBQ'
1305
1306        -
1307        -  a
1308
1309        -  r\ :sub:`4`
1310
1311        -  r\ :sub:`3`
1312
1313        -  r\ :sub:`2`
1314
1315        -  r\ :sub:`1`
1316
1317        -  r\ :sub:`0`
1318
1319        -  g\ :sub:`4`
1320
1321        -  g\ :sub:`3`
1322
1323        -
1324        -  g\ :sub:`2`
1325
1326        -  g\ :sub:`1`
1327
1328        -  g\ :sub:`0`
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     -  .. _V4L2-PIX-FMT-BGR32:
1341
1342        -  ``V4L2_PIX_FMT_BGR32``
1343
1344        -  'BGR4'
1345
1346        -
1347        -  b\ :sub:`7`
1348
1349        -  b\ :sub:`6`
1350
1351        -  b\ :sub:`5`
1352
1353        -  b\ :sub:`4`
1354
1355        -  b\ :sub:`3`
1356
1357        -  b\ :sub:`2`
1358
1359        -  b\ :sub:`1`
1360
1361        -  b\ :sub:`0`
1362
1363        -
1364        -  g\ :sub:`7`
1365
1366        -  g\ :sub:`6`
1367
1368        -  g\ :sub:`5`
1369
1370        -  g\ :sub:`4`
1371
1372        -  g\ :sub:`3`
1373
1374        -  g\ :sub:`2`
1375
1376        -  g\ :sub:`1`
1377
1378        -  g\ :sub:`0`
1379
1380        -
1381        -  r\ :sub:`7`
1382
1383        -  r\ :sub:`6`
1384
1385        -  r\ :sub:`5`
1386
1387        -  r\ :sub:`4`
1388
1389        -  r\ :sub:`3`
1390
1391        -  r\ :sub:`2`
1392
1393        -  r\ :sub:`1`
1394
1395        -  r\ :sub:`0`
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     -  .. _V4L2-PIX-FMT-RGB32:
1415
1416        -  ``V4L2_PIX_FMT_RGB32``
1417
1418        -  'RGB4'
1419
1420        -
1421        -  a\ :sub:`7`
1422
1423        -  a\ :sub:`6`
1424
1425        -  a\ :sub:`5`
1426
1427        -  a\ :sub:`4`
1428
1429        -  a\ :sub:`3`
1430
1431        -  a\ :sub:`2`
1432
1433        -  a\ :sub:`1`
1434
1435        -  a\ :sub:`0`
1436
1437        -
1438        -  r\ :sub:`7`
1439
1440        -  r\ :sub:`6`
1441
1442        -  r\ :sub:`5`
1443
1444        -  r\ :sub:`4`
1445
1446        -  r\ :sub:`3`
1447
1448        -  r\ :sub:`2`
1449
1450        -  r\ :sub:`1`
1451
1452        -  r\ :sub:`0`
1453
1454        -
1455        -  g\ :sub:`7`
1456
1457        -  g\ :sub:`6`
1458
1459        -  g\ :sub:`5`
1460
1461        -  g\ :sub:`4`
1462
1463        -  g\ :sub:`3`
1464
1465        -  g\ :sub:`2`
1466
1467        -  g\ :sub:`1`
1468
1469        -  g\ :sub:`0`
1470
1471        -
1472        -  b\ :sub:`7`
1473
1474        -  b\ :sub:`6`
1475
1476        -  b\ :sub:`5`
1477
1478        -  b\ :sub:`4`
1479
1480        -  b\ :sub:`3`
1481
1482        -  b\ :sub:`2`
1483
1484        -  b\ :sub:`1`
1485
1486        -  b\ :sub:`0`
1487
1488 .. raw:: latex
1489
1490     \end{adjustbox}\newline\newline
1491
1492 A test utility to determine which RGB formats a driver actually supports
1493 is available from the LinuxTV v4l-dvb repository. See
1494 `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access
1495 instructions.