Documentation/DocBook/v4l/pixfmt-packed-rgb.xml

   1 <refentry id="packed-rgb">
   2   <refmeta>
   3     <refentrytitle>Packed RGB formats</refentrytitle>
   4     &manvol;
   5   </refmeta>
   6   <refnamediv>
   7     <refname>Packed RGB formats</refname>
   8     <refpurpose>Packed RGB formats</refpurpose>
   9   </refnamediv>
  10   <refsect1>
  11     <title>Description</title>
  12
  13     <para>These formats are designed to match the pixel formats of
  14 typical PC graphics frame buffers. They occupy 8, 16, 24 or 32 bits
  15 per pixel. These are all packed-pixel formats, meaning all the data
  16 for a pixel lie next to each other in memory.</para>
  17
  18     <para>When one of these formats is used, drivers shall report the
  19 colorspace <constant>V4L2_COLORSPACE_SRGB</constant>.</para>
  20
  21     <table pgwide="1" frame="none" id="rgb-formats">
  22       <title>Packed RGB Image Formats</title>
  23       <tgroup cols="37" align="center">
  24         <colspec colname="id" align="left" />
  25         <colspec colname="fourcc" />
  26         <colspec colname="bit" />
  27
  28         <colspec colnum="4" colname="b07" align="center" />
  29         <colspec colnum="5" colname="b06" align="center" />
  30         <colspec colnum="6" colname="b05" align="center" />
  31         <colspec colnum="7" colname="b04" align="center" />
  32         <colspec colnum="8" colname="b03" align="center" />
  33         <colspec colnum="9" colname="b02" align="center" />
  34         <colspec colnum="10" colname="b01" align="center" />
  35         <colspec colnum="11" colname="b00" align="center" />
  36
  37         <colspec colnum="13" colname="b17" align="center" />
  38         <colspec colnum="14" colname="b16" align="center" />
  39         <colspec colnum="15" colname="b15" align="center" />
  40         <colspec colnum="16" colname="b14" align="center" />
  41         <colspec colnum="17" colname="b13" align="center" />
  42         <colspec colnum="18" colname="b12" align="center" />
  43         <colspec colnum="19" colname="b11" align="center" />
  44         <colspec colnum="20" colname="b10" align="center" />
  45
  46         <colspec colnum="22" colname="b27" align="center" />
  47         <colspec colnum="23" colname="b26" align="center" />
  48         <colspec colnum="24" colname="b25" align="center" />
  49         <colspec colnum="25" colname="b24" align="center" />
  50         <colspec colnum="26" colname="b23" align="center" />
  51         <colspec colnum="27" colname="b22" align="center" />
  52         <colspec colnum="28" colname="b21" align="center" />
  53         <colspec colnum="29" colname="b20" align="center" />
  54
  55         <colspec colnum="31" colname="b37" align="center" />
  56         <colspec colnum="32" colname="b36" align="center" />
  57         <colspec colnum="33" colname="b35" align="center" />
  58         <colspec colnum="34" colname="b34" align="center" />
  59         <colspec colnum="35" colname="b33" align="center" />
  60         <colspec colnum="36" colname="b32" align="center" />
  61         <colspec colnum="37" colname="b31" align="center" />
  62         <colspec colnum="38" colname="b30" align="center" />
  63
  64         <spanspec namest="b07" nameend="b00" spanname="b0" />
  65         <spanspec namest="b17" nameend="b10" spanname="b1" />
  66         <spanspec namest="b27" nameend="b20" spanname="b2" />
  67         <spanspec namest="b37" nameend="b30" spanname="b3" />
  68         <thead>
  69           <row>
  70             <entry>Identifier</entry>
  71             <entry>Code</entry>
  72             <entry>&nbsp;</entry>
  73             <entry spanname="b0">Byte&nbsp;0 in memory</entry>
  74             <entry spanname="b1">Byte&nbsp;1</entry>
  75             <entry spanname="b2">Byte&nbsp;2</entry>
  76             <entry spanname="b3">Byte&nbsp;3</entry>
  77           </row>
  78           <row>
  79             <entry>&nbsp;</entry>
  80             <entry>&nbsp;</entry>
  81             <entry>Bit</entry>
  82             <entry>7</entry>
  83             <entry>6</entry>
  84             <entry>5</entry>
  85             <entry>4</entry>
  86             <entry>3</entry>
  87             <entry>2</entry>
  88             <entry>1</entry>
  89             <entry>0</entry>
  90             <entry>&nbsp;</entry>
  91             <entry>7</entry>
  92             <entry>6</entry>
  93             <entry>5</entry>
  94             <entry>4</entry>
  95             <entry>3</entry>
  96             <entry>2</entry>
  97             <entry>1</entry>
  98             <entry>0</entry>
  99             <entry>&nbsp;</entry>
 100             <entry>7</entry>
 101             <entry>6</entry>
 102             <entry>5</entry>
 103             <entry>4</entry>
 104             <entry>3</entry>
 105             <entry>2</entry>
 106             <entry>1</entry>
 107             <entry>0</entry>
 108             <entry>&nbsp;</entry>
 109             <entry>7</entry>
 110             <entry>6</entry>
 111             <entry>5</entry>
 112             <entry>4</entry>
 113             <entry>3</entry>
 114             <entry>2</entry>
 115             <entry>1</entry>
 116             <entry>0</entry>
 117           </row>
 118         </thead>
 119         <tbody valign="top">
 120           <row id="V4L2-PIX-FMT-RGB332">
 121             <entry><constant>V4L2_PIX_FMT_RGB332</constant></entry>
 122             <entry>'RGB1'</entry>
 123             <entry></entry>
 124             <entry>b<subscript>1</subscript></entry>
 125             <entry>b<subscript>0</subscript></entry>
 126             <entry>g<subscript>2</subscript></entry>
 127             <entry>g<subscript>1</subscript></entry>
 128             <entry>g<subscript>0</subscript></entry>
 129             <entry>r<subscript>2</subscript></entry>
 130             <entry>r<subscript>1</subscript></entry>
 131             <entry>r<subscript>0</subscript></entry>
 132           </row>
 133           <row id="V4L2-PIX-FMT-RGB444">
 134             <entry><constant>V4L2_PIX_FMT_RGB444</constant></entry>
 135             <entry>'R444'</entry>
 136             <entry></entry>
 137             <entry>g<subscript>3</subscript></entry>
 138             <entry>g<subscript>2</subscript></entry>
 139             <entry>g<subscript>1</subscript></entry>
 140             <entry>g<subscript>0</subscript></entry>
 141             <entry>b<subscript>3</subscript></entry>
 142             <entry>b<subscript>2</subscript></entry>
 143             <entry>b<subscript>1</subscript></entry>
 144             <entry>b<subscript>0</subscript></entry>
 145             <entry></entry>
 146             <entry>a<subscript>3</subscript></entry>
 147             <entry>a<subscript>2</subscript></entry>
 148             <entry>a<subscript>1</subscript></entry>
 149             <entry>a<subscript>0</subscript></entry>
 150             <entry>r<subscript>3</subscript></entry>
 151             <entry>r<subscript>2</subscript></entry>
 152             <entry>r<subscript>1</subscript></entry>
 153             <entry>r<subscript>0</subscript></entry>
 154           </row>
 155           <row id="V4L2-PIX-FMT-RGB555">
 156             <entry><constant>V4L2_PIX_FMT_RGB555</constant></entry>
 157             <entry>'RGBO'</entry>
 158             <entry></entry>
 159             <entry>g<subscript>2</subscript></entry>
 160             <entry>g<subscript>1</subscript></entry>
 161             <entry>g<subscript>0</subscript></entry>
 162             <entry>r<subscript>4</subscript></entry>
 163             <entry>r<subscript>3</subscript></entry>
 164             <entry>r<subscript>2</subscript></entry>
 165             <entry>r<subscript>1</subscript></entry>
 166             <entry>r<subscript>0</subscript></entry>
 167             <entry></entry>
 168             <entry>a</entry>
 169             <entry>b<subscript>4</subscript></entry>
 170             <entry>b<subscript>3</subscript></entry>
 171             <entry>b<subscript>2</subscript></entry>
 172             <entry>b<subscript>1</subscript></entry>
 173             <entry>b<subscript>0</subscript></entry>
 174             <entry>g<subscript>4</subscript></entry>
 175             <entry>g<subscript>3</subscript></entry>
 176           </row>
 177           <row id="V4L2-PIX-FMT-RGB565">
 178             <entry><constant>V4L2_PIX_FMT_RGB565</constant></entry>
 179             <entry>'RGBP'</entry>
 180             <entry></entry>
 181             <entry>g<subscript>2</subscript></entry>
 182             <entry>g<subscript>1</subscript></entry>
 183             <entry>g<subscript>0</subscript></entry>
 184             <entry>r<subscript>4</subscript></entry>
 185             <entry>r<subscript>3</subscript></entry>
 186             <entry>r<subscript>2</subscript></entry>
 187             <entry>r<subscript>1</subscript></entry>
 188             <entry>r<subscript>0</subscript></entry>
 189             <entry></entry>
 190             <entry>b<subscript>4</subscript></entry>
 191             <entry>b<subscript>3</subscript></entry>
 192             <entry>b<subscript>2</subscript></entry>
 193             <entry>b<subscript>1</subscript></entry>
 194             <entry>b<subscript>0</subscript></entry>
 195             <entry>g<subscript>5</subscript></entry>
 196             <entry>g<subscript>4</subscript></entry>
 197             <entry>g<subscript>3</subscript></entry>
 198           </row>
 199           <row id="V4L2-PIX-FMT-RGB555X">
 200             <entry><constant>V4L2_PIX_FMT_RGB555X</constant></entry>
 201             <entry>'RGBQ'</entry>
 202             <entry></entry>
 203             <entry>a</entry>
 204             <entry>b<subscript>4</subscript></entry>
 205             <entry>b<subscript>3</subscript></entry>
 206             <entry>b<subscript>2</subscript></entry>
 207             <entry>b<subscript>1</subscript></entry>
 208             <entry>b<subscript>0</subscript></entry>
 209             <entry>g<subscript>4</subscript></entry>
 210             <entry>g<subscript>3</subscript></entry>
 211             <entry></entry>
 212             <entry>g<subscript>2</subscript></entry>
 213             <entry>g<subscript>1</subscript></entry>
 214             <entry>g<subscript>0</subscript></entry>
 215             <entry>r<subscript>4</subscript></entry>
 216             <entry>r<subscript>3</subscript></entry>
 217             <entry>r<subscript>2</subscript></entry>
 218             <entry>r<subscript>1</subscript></entry>
 219             <entry>r<subscript>0</subscript></entry>
 220           </row>
 221           <row id="V4L2-PIX-FMT-RGB565X">
 222             <entry><constant>V4L2_PIX_FMT_RGB565X</constant></entry>
 223             <entry>'RGBR'</entry>
 224             <entry></entry>
 225             <entry>b<subscript>4</subscript></entry>
 226             <entry>b<subscript>3</subscript></entry>
 227             <entry>b<subscript>2</subscript></entry>
 228             <entry>b<subscript>1</subscript></entry>
 229             <entry>b<subscript>0</subscript></entry>
 230             <entry>g<subscript>5</subscript></entry>
 231             <entry>g<subscript>4</subscript></entry>
 232             <entry>g<subscript>3</subscript></entry>
 233             <entry></entry>
 234             <entry>g<subscript>2</subscript></entry>
 235             <entry>g<subscript>1</subscript></entry>
 236             <entry>g<subscript>0</subscript></entry>
 237             <entry>r<subscript>4</subscript></entry>
 238             <entry>r<subscript>3</subscript></entry>
 239             <entry>r<subscript>2</subscript></entry>
 240             <entry>r<subscript>1</subscript></entry>
 241             <entry>r<subscript>0</subscript></entry>
 242           </row>
 243           <row id="V4L2-PIX-FMT-BGR666">
 244             <entry><constant>V4L2_PIX_FMT_BGR666</constant></entry>
 245             <entry>'BGRH'</entry>
 246             <entry></entry>
 247             <entry>b<subscript>5</subscript></entry>
 248             <entry>b<subscript>4</subscript></entry>
 249             <entry>b<subscript>3</subscript></entry>
 250             <entry>b<subscript>2</subscript></entry>
 251             <entry>b<subscript>1</subscript></entry>
 252             <entry>b<subscript>0</subscript></entry>
 253             <entry>g<subscript>5</subscript></entry>
 254             <entry>g<subscript>4</subscript></entry>
 255             <entry></entry>
 256             <entry>g<subscript>3</subscript></entry>
 257             <entry>g<subscript>2</subscript></entry>
 258             <entry>g<subscript>1</subscript></entry>
 259             <entry>g<subscript>0</subscript></entry>
 260             <entry>r<subscript>5</subscript></entry>
 261             <entry>r<subscript>4</subscript></entry>
 262             <entry>r<subscript>3</subscript></entry>
 263             <entry>r<subscript>2</subscript></entry>
 264             <entry></entry>
 265             <entry>r<subscript>1</subscript></entry>
 266             <entry>r<subscript>0</subscript></entry>
 267             <entry></entry>
 268             <entry></entry>
 269             <entry></entry>
 270             <entry></entry>
 271             <entry></entry>
 272             <entry></entry>
 273             <entry></entry>
 274             <entry></entry>
 275             <entry></entry>
 276             <entry></entry>
 277             <entry></entry>
 278             <entry></entry>
 279             <entry></entry>
 280             <entry></entry>
 281           </row>
 282           <row id="V4L2-PIX-FMT-BGR24">
 283             <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry>
 284             <entry>'BGR3'</entry>
 285             <entry></entry>
 286             <entry>b<subscript>7</subscript></entry>
 287             <entry>b<subscript>6</subscript></entry>
 288             <entry>b<subscript>5</subscript></entry>
 289             <entry>b<subscript>4</subscript></entry>
 290             <entry>b<subscript>3</subscript></entry>
 291             <entry>b<subscript>2</subscript></entry>
 292             <entry>b<subscript>1</subscript></entry>
 293             <entry>b<subscript>0</subscript></entry>
 294             <entry></entry>
 295             <entry>g<subscript>7</subscript></entry>
 296             <entry>g<subscript>6</subscript></entry>
 297             <entry>g<subscript>5</subscript></entry>
 298             <entry>g<subscript>4</subscript></entry>
 299             <entry>g<subscript>3</subscript></entry>
 300             <entry>g<subscript>2</subscript></entry>
 301             <entry>g<subscript>1</subscript></entry>
 302             <entry>g<subscript>0</subscript></entry>
 303             <entry></entry>
 304             <entry>r<subscript>7</subscript></entry>
 305             <entry>r<subscript>6</subscript></entry>
 306             <entry>r<subscript>5</subscript></entry>
 307             <entry>r<subscript>4</subscript></entry>
 308             <entry>r<subscript>3</subscript></entry>
 309             <entry>r<subscript>2</subscript></entry>
 310             <entry>r<subscript>1</subscript></entry>
 311             <entry>r<subscript>0</subscript></entry>
 312           </row>
 313           <row id="V4L2-PIX-FMT-RGB24">
 314             <entry><constant>V4L2_PIX_FMT_RGB24</constant></entry>
 315             <entry>'RGB3'</entry>
 316             <entry></entry>
 317             <entry>r<subscript>7</subscript></entry>
 318             <entry>r<subscript>6</subscript></entry>
 319             <entry>r<subscript>5</subscript></entry>
 320             <entry>r<subscript>4</subscript></entry>
 321             <entry>r<subscript>3</subscript></entry>
 322             <entry>r<subscript>2</subscript></entry>
 323             <entry>r<subscript>1</subscript></entry>
 324             <entry>r<subscript>0</subscript></entry>
 325             <entry></entry>
 326             <entry>g<subscript>7</subscript></entry>
 327             <entry>g<subscript>6</subscript></entry>
 328             <entry>g<subscript>5</subscript></entry>
 329             <entry>g<subscript>4</subscript></entry>
 330             <entry>g<subscript>3</subscript></entry>
 331             <entry>g<subscript>2</subscript></entry>
 332             <entry>g<subscript>1</subscript></entry>
 333             <entry>g<subscript>0</subscript></entry>
 334             <entry></entry>
 335             <entry>b<subscript>7</subscript></entry>
 336             <entry>b<subscript>6</subscript></entry>
 337             <entry>b<subscript>5</subscript></entry>
 338             <entry>b<subscript>4</subscript></entry>
 339             <entry>b<subscript>3</subscript></entry>
 340             <entry>b<subscript>2</subscript></entry>
 341             <entry>b<subscript>1</subscript></entry>
 342             <entry>b<subscript>0</subscript></entry>
 343           </row>
 344           <row id="V4L2-PIX-FMT-BGR32">
 345             <entry><constant>V4L2_PIX_FMT_BGR32</constant></entry>
 346             <entry>'BGR4'</entry>
 347             <entry></entry>
 348             <entry>b<subscript>7</subscript></entry>
 349             <entry>b<subscript>6</subscript></entry>
 350             <entry>b<subscript>5</subscript></entry>
 351             <entry>b<subscript>4</subscript></entry>
 352             <entry>b<subscript>3</subscript></entry>
 353             <entry>b<subscript>2</subscript></entry>
 354             <entry>b<subscript>1</subscript></entry>
 355             <entry>b<subscript>0</subscript></entry>
 356             <entry></entry>
 357             <entry>g<subscript>7</subscript></entry>
 358             <entry>g<subscript>6</subscript></entry>
 359             <entry>g<subscript>5</subscript></entry>
 360             <entry>g<subscript>4</subscript></entry>
 361             <entry>g<subscript>3</subscript></entry>
 362             <entry>g<subscript>2</subscript></entry>
 363             <entry>g<subscript>1</subscript></entry>
 364             <entry>g<subscript>0</subscript></entry>
 365             <entry></entry>
 366             <entry>r<subscript>7</subscript></entry>
 367             <entry>r<subscript>6</subscript></entry>
 368             <entry>r<subscript>5</subscript></entry>
 369             <entry>r<subscript>4</subscript></entry>
 370             <entry>r<subscript>3</subscript></entry>
 371             <entry>r<subscript>2</subscript></entry>
 372             <entry>r<subscript>1</subscript></entry>
 373             <entry>r<subscript>0</subscript></entry>
 374             <entry></entry>
 375             <entry>a<subscript>7</subscript></entry>
 376             <entry>a<subscript>6</subscript></entry>
 377             <entry>a<subscript>5</subscript></entry>
 378             <entry>a<subscript>4</subscript></entry>
 379             <entry>a<subscript>3</subscript></entry>
 380             <entry>a<subscript>2</subscript></entry>
 381             <entry>a<subscript>1</subscript></entry>
 382             <entry>a<subscript>0</subscript></entry>
 383           </row>
 384           <row id="V4L2-PIX-FMT-RGB32">
 385             <entry><constant>V4L2_PIX_FMT_RGB32</constant></entry>
 386             <entry>'RGB4'</entry>
 387             <entry></entry>
 388             <entry>r<subscript>7</subscript></entry>
 389             <entry>r<subscript>6</subscript></entry>
 390             <entry>r<subscript>5</subscript></entry>
 391             <entry>r<subscript>4</subscript></entry>
 392             <entry>r<subscript>3</subscript></entry>
 393             <entry>r<subscript>2</subscript></entry>
 394             <entry>r<subscript>1</subscript></entry>
 395             <entry>r<subscript>0</subscript></entry>
 396             <entry></entry>
 397             <entry>g<subscript>7</subscript></entry>
 398             <entry>g<subscript>6</subscript></entry>
 399             <entry>g<subscript>5</subscript></entry>
 400             <entry>g<subscript>4</subscript></entry>
 401             <entry>g<subscript>3</subscript></entry>
 402             <entry>g<subscript>2</subscript></entry>
 403             <entry>g<subscript>1</subscript></entry>
 404             <entry>g<subscript>0</subscript></entry>
 405             <entry></entry>
 406             <entry>b<subscript>7</subscript></entry>
 407             <entry>b<subscript>6</subscript></entry>
 408             <entry>b<subscript>5</subscript></entry>
 409             <entry>b<subscript>4</subscript></entry>
 410             <entry>b<subscript>3</subscript></entry>
 411             <entry>b<subscript>2</subscript></entry>
 412             <entry>b<subscript>1</subscript></entry>
 413             <entry>b<subscript>0</subscript></entry>
 414             <entry></entry>
 415             <entry>a<subscript>7</subscript></entry>
 416             <entry>a<subscript>6</subscript></entry>
 417             <entry>a<subscript>5</subscript></entry>
 418             <entry>a<subscript>4</subscript></entry>
 419             <entry>a<subscript>3</subscript></entry>
 420             <entry>a<subscript>2</subscript></entry>
 421             <entry>a<subscript>1</subscript></entry>
 422             <entry>a<subscript>0</subscript></entry>
 423           </row>
 424         </tbody>
 425       </tgroup>
 426     </table>
 427
 428     <para>Bit 7 is the most significant bit. The value of a = alpha
 429 bits is undefined when reading from the driver, ignored when writing
 430 to the driver, except when alpha blending has been negotiated for a
 431 <link linkend="overlay">Video Overlay</link> or <link
 432 linkend="osd">Video Output Overlay</link>.</para>
 433
 434     <example>
 435       <title><constant>V4L2_PIX_FMT_BGR24</constant> 4 &times; 4 pixel
 436 image</title>
 437
 438       <formalpara>
 439         <title>Byte Order.</title>
 440         <para>Each cell is one byte.
 441               <informaltable frame="none">
 442             <tgroup cols="13" align="center">
 443               <colspec align="left" colwidth="2*" />
 444               <tbody valign="top">
 445                 <row>
 446                   <entry>start&nbsp;+&nbsp;0:</entry>
 447                   <entry>B<subscript>00</subscript></entry>
 448                   <entry>G<subscript>00</subscript></entry>
 449                   <entry>R<subscript>00</subscript></entry>
 450                   <entry>B<subscript>01</subscript></entry>
 451                   <entry>G<subscript>01</subscript></entry>
 452                   <entry>R<subscript>01</subscript></entry>
 453                   <entry>B<subscript>02</subscript></entry>
 454                   <entry>G<subscript>02</subscript></entry>
 455                   <entry>R<subscript>02</subscript></entry>
 456                   <entry>B<subscript>03</subscript></entry>
 457                   <entry>G<subscript>03</subscript></entry>
 458                   <entry>R<subscript>03</subscript></entry>
 459                 </row>
 460                 <row>
 461                   <entry>start&nbsp;+&nbsp;12:</entry>
 462                   <entry>B<subscript>10</subscript></entry>
 463                   <entry>G<subscript>10</subscript></entry>
 464                   <entry>R<subscript>10</subscript></entry>
 465                   <entry>B<subscript>11</subscript></entry>
 466                   <entry>G<subscript>11</subscript></entry>
 467                   <entry>R<subscript>11</subscript></entry>
 468                   <entry>B<subscript>12</subscript></entry>
 469                   <entry>G<subscript>12</subscript></entry>
 470                   <entry>R<subscript>12</subscript></entry>
 471                   <entry>B<subscript>13</subscript></entry>
 472                   <entry>G<subscript>13</subscript></entry>
 473                   <entry>R<subscript>13</subscript></entry>
 474                 </row>
 475                 <row>
 476                   <entry>start&nbsp;+&nbsp;24:</entry>
 477                   <entry>B<subscript>20</subscript></entry>
 478                   <entry>G<subscript>20</subscript></entry>
 479                   <entry>R<subscript>20</subscript></entry>
 480                   <entry>B<subscript>21</subscript></entry>
 481                   <entry>G<subscript>21</subscript></entry>
 482                   <entry>R<subscript>21</subscript></entry>
 483                   <entry>B<subscript>22</subscript></entry>
 484                   <entry>G<subscript>22</subscript></entry>
 485                   <entry>R<subscript>22</subscript></entry>
 486                   <entry>B<subscript>23</subscript></entry>
 487                   <entry>G<subscript>23</subscript></entry>
 488                   <entry>R<subscript>23</subscript></entry>
 489                 </row>
 490                 <row>
 491                   <entry>start&nbsp;+&nbsp;36:</entry>
 492                   <entry>B<subscript>30</subscript></entry>
 493                   <entry>G<subscript>30</subscript></entry>
 494                   <entry>R<subscript>30</subscript></entry>
 495                   <entry>B<subscript>31</subscript></entry>
 496                   <entry>G<subscript>31</subscript></entry>
 497                   <entry>R<subscript>31</subscript></entry>
 498                   <entry>B<subscript>32</subscript></entry>
 499                   <entry>G<subscript>32</subscript></entry>
 500                   <entry>R<subscript>32</subscript></entry>
 501                   <entry>B<subscript>33</subscript></entry>
 502                   <entry>G<subscript>33</subscript></entry>
 503                   <entry>R<subscript>33</subscript></entry>
 504                 </row>
 505               </tbody>
 506             </tgroup>
 507               </informaltable>
 508             </para>
 509       </formalpara>
 510     </example>
 511
 512     <important>
 513       <para>Drivers may interpret these formats differently.</para>
 514     </important>
 515
 516     <para>Some RGB formats above are uncommon and were probably
 517 defined in error. Drivers may interpret them as in <xref
 518         linkend="rgb-formats-corrected" />.</para>
 519
 520     <table pgwide="1" frame="none" id="rgb-formats-corrected">
 521       <title>Packed RGB Image Formats (corrected)</title>
 522       <tgroup cols="37" align="center">
 523         <colspec colname="id" align="left" />
 524         <colspec colname="fourcc" />
 525         <colspec colname="bit" />
 526
 527         <colspec colnum="4" colname="b07" align="center" />
 528         <colspec colnum="5" colname="b06" align="center" />
 529         <colspec colnum="6" colname="b05" align="center" />
 530         <colspec colnum="7" colname="b04" align="center" />
 531         <colspec colnum="8" colname="b03" align="center" />
 532         <colspec colnum="9" colname="b02" align="center" />
 533         <colspec colnum="10" colname="b01" align="center" />
 534         <colspec colnum="11" colname="b00" align="center" />
 535
 536         <colspec colnum="13" colname="b17" align="center" />
 537         <colspec colnum="14" colname="b16" align="center" />
 538         <colspec colnum="15" colname="b15" align="center" />
 539         <colspec colnum="16" colname="b14" align="center" />
 540         <colspec colnum="17" colname="b13" align="center" />
 541         <colspec colnum="18" colname="b12" align="center" />
 542         <colspec colnum="19" colname="b11" align="center" />
 543         <colspec colnum="20" colname="b10" align="center" />
 544
 545         <colspec colnum="22" colname="b27" align="center" />
 546         <colspec colnum="23" colname="b26" align="center" />
 547         <colspec colnum="24" colname="b25" align="center" />
 548         <colspec colnum="25" colname="b24" align="center" />
 549         <colspec colnum="26" colname="b23" align="center" />
 550         <colspec colnum="27" colname="b22" align="center" />
 551         <colspec colnum="28" colname="b21" align="center" />
 552         <colspec colnum="29" colname="b20" align="center" />
 553
 554         <colspec colnum="31" colname="b37" align="center" />
 555         <colspec colnum="32" colname="b36" align="center" />
 556         <colspec colnum="33" colname="b35" align="center" />
 557         <colspec colnum="34" colname="b34" align="center" />
 558         <colspec colnum="35" colname="b33" align="center" />
 559         <colspec colnum="36" colname="b32" align="center" />
 560         <colspec colnum="37" colname="b31" align="center" />
 561         <colspec colnum="38" colname="b30" align="center" />
 562
 563         <spanspec namest="b07" nameend="b00" spanname="b0" />
 564         <spanspec namest="b17" nameend="b10" spanname="b1" />
 565         <spanspec namest="b27" nameend="b20" spanname="b2" />
 566         <spanspec namest="b37" nameend="b30" spanname="b3" />
 567         <thead>
 568           <row>
 569             <entry>Identifier</entry>
 570             <entry>Code</entry>
 571             <entry>&nbsp;</entry>
 572             <entry spanname="b0">Byte&nbsp;0 in memory</entry>
 573             <entry spanname="b1">Byte&nbsp;1</entry>
 574             <entry spanname="b2">Byte&nbsp;2</entry>
 575             <entry spanname="b3">Byte&nbsp;3</entry>
 576           </row>
 577           <row>
 578             <entry>&nbsp;</entry>
 579             <entry>&nbsp;</entry>
 580             <entry>Bit</entry>
 581             <entry>7</entry>
 582             <entry>6</entry>
 583             <entry>5</entry>
 584             <entry>4</entry>
 585             <entry>3</entry>
 586             <entry>2</entry>
 587             <entry>1</entry>
 588             <entry>0</entry>
 589             <entry>&nbsp;</entry>
 590             <entry>7</entry>
 591             <entry>6</entry>
 592             <entry>5</entry>
 593             <entry>4</entry>
 594             <entry>3</entry>
 595             <entry>2</entry>
 596             <entry>1</entry>
 597             <entry>0</entry>
 598             <entry>&nbsp;</entry>
 599             <entry>7</entry>
 600             <entry>6</entry>
 601             <entry>5</entry>
 602             <entry>4</entry>
 603             <entry>3</entry>
 604             <entry>2</entry>
 605             <entry>1</entry>
 606             <entry>0</entry>
 607             <entry>&nbsp;</entry>
 608             <entry>7</entry>
 609             <entry>6</entry>
 610             <entry>5</entry>
 611             <entry>4</entry>
 612             <entry>3</entry>
 613             <entry>2</entry>
 614             <entry>1</entry>
 615             <entry>0</entry>
 616           </row>
 617         </thead>
 618         <tbody valign="top">
 619           <row><!-- id="V4L2-PIX-FMT-RGB332" -->
 620             <entry><constant>V4L2_PIX_FMT_RGB332</constant></entry>
 621             <entry>'RGB1'</entry>
 622             <entry></entry>
 623             <entry>r<subscript>2</subscript></entry>
 624             <entry>r<subscript>1</subscript></entry>
 625             <entry>r<subscript>0</subscript></entry>
 626             <entry>g<subscript>2</subscript></entry>
 627             <entry>g<subscript>1</subscript></entry>
 628             <entry>g<subscript>0</subscript></entry>
 629             <entry>b<subscript>1</subscript></entry>
 630             <entry>b<subscript>0</subscript></entry>
 631           </row>
 632           <row><!-- id="V4L2-PIX-FMT-RGB444" -->
 633             <entry><constant>V4L2_PIX_FMT_RGB444</constant></entry>
 634             <entry>'R444'</entry>
 635             <entry></entry>
 636             <entry>g<subscript>3</subscript></entry>
 637             <entry>g<subscript>2</subscript></entry>
 638             <entry>g<subscript>1</subscript></entry>
 639             <entry>g<subscript>0</subscript></entry>
 640             <entry>b<subscript>3</subscript></entry>
 641             <entry>b<subscript>2</subscript></entry>
 642             <entry>b<subscript>1</subscript></entry>
 643             <entry>b<subscript>0</subscript></entry>
 644             <entry></entry>
 645             <entry>a<subscript>3</subscript></entry>
 646             <entry>a<subscript>2</subscript></entry>
 647             <entry>a<subscript>1</subscript></entry>
 648             <entry>a<subscript>0</subscript></entry>
 649             <entry>r<subscript>3</subscript></entry>
 650             <entry>r<subscript>2</subscript></entry>
 651             <entry>r<subscript>1</subscript></entry>
 652             <entry>r<subscript>0</subscript></entry>
 653           </row>
 654           <row><!-- id="V4L2-PIX-FMT-RGB555" -->
 655             <entry><constant>V4L2_PIX_FMT_RGB555</constant></entry>
 656             <entry>'RGBO'</entry>
 657             <entry></entry>
 658             <entry>g<subscript>2</subscript></entry>
 659             <entry>g<subscript>1</subscript></entry>
 660             <entry>g<subscript>0</subscript></entry>
 661             <entry>b<subscript>4</subscript></entry>
 662             <entry>b<subscript>3</subscript></entry>
 663             <entry>b<subscript>2</subscript></entry>
 664             <entry>b<subscript>1</subscript></entry>
 665             <entry>b<subscript>0</subscript></entry>
 666             <entry></entry>
 667             <entry>a</entry>
 668             <entry>r<subscript>4</subscript></entry>
 669             <entry>r<subscript>3</subscript></entry>
 670             <entry>r<subscript>2</subscript></entry>
 671             <entry>r<subscript>1</subscript></entry>
 672             <entry>r<subscript>0</subscript></entry>
 673             <entry>g<subscript>4</subscript></entry>
 674             <entry>g<subscript>3</subscript></entry>
 675           </row>
 676           <row><!-- id="V4L2-PIX-FMT-RGB565" -->
 677             <entry><constant>V4L2_PIX_FMT_RGB565</constant></entry>
 678             <entry>'RGBP'</entry>
 679             <entry></entry>
 680             <entry>g<subscript>2</subscript></entry>
 681             <entry>g<subscript>1</subscript></entry>
 682             <entry>g<subscript>0</subscript></entry>
 683             <entry>b<subscript>4</subscript></entry>
 684             <entry>b<subscript>3</subscript></entry>
 685             <entry>b<subscript>2</subscript></entry>
 686             <entry>b<subscript>1</subscript></entry>
 687             <entry>b<subscript>0</subscript></entry>
 688             <entry></entry>
 689             <entry>r<subscript>4</subscript></entry>
 690             <entry>r<subscript>3</subscript></entry>
 691             <entry>r<subscript>2</subscript></entry>
 692             <entry>r<subscript>1</subscript></entry>
 693             <entry>r<subscript>0</subscript></entry>
 694             <entry>g<subscript>5</subscript></entry>
 695             <entry>g<subscript>4</subscript></entry>
 696             <entry>g<subscript>3</subscript></entry>
 697           </row>
 698           <row><!-- id="V4L2-PIX-FMT-RGB555X" -->
 699             <entry><constant>V4L2_PIX_FMT_RGB555X</constant></entry>
 700             <entry>'RGBQ'</entry>
 701             <entry></entry>
 702             <entry>a</entry>
 703             <entry>r<subscript>4</subscript></entry>
 704             <entry>r<subscript>3</subscript></entry>
 705             <entry>r<subscript>2</subscript></entry>
 706             <entry>r<subscript>1</subscript></entry>
 707             <entry>r<subscript>0</subscript></entry>
 708             <entry>g<subscript>4</subscript></entry>
 709             <entry>g<subscript>3</subscript></entry>
 710             <entry></entry>
 711             <entry>g<subscript>2</subscript></entry>
 712             <entry>g<subscript>1</subscript></entry>
 713             <entry>g<subscript>0</subscript></entry>
 714             <entry>b<subscript>4</subscript></entry>
 715             <entry>b<subscript>3</subscript></entry>
 716             <entry>b<subscript>2</subscript></entry>
 717             <entry>b<subscript>1</subscript></entry>
 718             <entry>b<subscript>0</subscript></entry>
 719           </row>
 720           <row><!-- id="V4L2-PIX-FMT-RGB565X" -->
 721             <entry><constant>V4L2_PIX_FMT_RGB565X</constant></entry>
 722             <entry>'RGBR'</entry>
 723             <entry></entry>
 724             <entry>r<subscript>4</subscript></entry>
 725             <entry>r<subscript>3</subscript></entry>
 726             <entry>r<subscript>2</subscript></entry>
 727             <entry>r<subscript>1</subscript></entry>
 728             <entry>r<subscript>0</subscript></entry>
 729             <entry>g<subscript>5</subscript></entry>
 730             <entry>g<subscript>4</subscript></entry>
 731             <entry>g<subscript>3</subscript></entry>
 732             <entry></entry>
 733             <entry>g<subscript>2</subscript></entry>
 734             <entry>g<subscript>1</subscript></entry>
 735             <entry>g<subscript>0</subscript></entry>
 736             <entry>b<subscript>4</subscript></entry>
 737             <entry>b<subscript>3</subscript></entry>
 738             <entry>b<subscript>2</subscript></entry>
 739             <entry>b<subscript>1</subscript></entry>
 740             <entry>b<subscript>0</subscript></entry>
 741           </row>
 742           <row><!-- id="V4L2-PIX-FMT-BGR666" -->
 743             <entry><constant>V4L2_PIX_FMT_BGR666</constant></entry>
 744             <entry>'BGRH'</entry>
 745             <entry></entry>
 746             <entry>b<subscript>5</subscript></entry>
 747             <entry>b<subscript>4</subscript></entry>
 748             <entry>b<subscript>3</subscript></entry>
 749             <entry>b<subscript>2</subscript></entry>
 750             <entry>b<subscript>1</subscript></entry>
 751             <entry>b<subscript>0</subscript></entry>
 752             <entry>g<subscript>5</subscript></entry>
 753             <entry>g<subscript>4</subscript></entry>
 754             <entry></entry>
 755             <entry>g<subscript>3</subscript></entry>
 756             <entry>g<subscript>2</subscript></entry>
 757             <entry>g<subscript>1</subscript></entry>
 758             <entry>g<subscript>0</subscript></entry>
 759             <entry>r<subscript>5</subscript></entry>
 760             <entry>r<subscript>4</subscript></entry>
 761             <entry>r<subscript>3</subscript></entry>
 762             <entry>r<subscript>2</subscript></entry>
 763             <entry></entry>
 764             <entry>r<subscript>1</subscript></entry>
 765             <entry>r<subscript>0</subscript></entry>
 766             <entry></entry>
 767             <entry></entry>
 768             <entry></entry>
 769             <entry></entry>
 770             <entry></entry>
 771             <entry></entry>
 772             <entry></entry>
 773             <entry></entry>
 774             <entry></entry>
 775             <entry></entry>
 776             <entry></entry>
 777             <entry></entry>
 778             <entry></entry>
 779             <entry></entry>
 780           </row>
 781           <row><!-- id="V4L2-PIX-FMT-BGR24" -->
 782             <entry><constant>V4L2_PIX_FMT_BGR24</constant></entry>
 783             <entry>'BGR3'</entry>
 784             <entry></entry>
 785             <entry>b<subscript>7</subscript></entry>
 786             <entry>b<subscript>6</subscript></entry>
 787             <entry>b<subscript>5</subscript></entry>
 788             <entry>b<subscript>4</subscript></entry>
 789             <entry>b<subscript>3</subscript></entry>
 790             <entry>b<subscript>2</subscript></entry>
 791             <entry>b<subscript>1</subscript></entry>
 792             <entry>b<subscript>0</subscript></entry>
 793             <entry></entry>
 794             <entry>g<subscript>7</subscript></entry>
 795             <entry>g<subscript>6</subscript></entry>
 796             <entry>g<subscript>5</subscript></entry>
 797             <entry>g<subscript>4</subscript></entry>
 798             <entry>g<subscript>3</subscript></entry>
 799             <entry>g<subscript>2</subscript></entry>
 800             <entry>g<subscript>1</subscript></entry>
 801             <entry>g<subscript>0</subscript></entry>
 802             <entry></entry>
 803             <entry>r<subscript>7</subscript></entry>
 804             <entry>r<subscript>6</subscript></entry>
 805             <entry>r<subscript>5</subscript></entry>
 806             <entry>r<subscript>4</subscript></entry>
 807             <entry>r<subscript>3</subscript></entry>
 808             <entry>r<subscript>2</subscript></entry>
 809             <entry>r<subscript>1</subscript></entry>
 810             <entry>r<subscript>0</subscript></entry>
 811           </row>
 812           <row><!-- id="V4L2-PIX-FMT-RGB24" -->
 813             <entry><constant>V4L2_PIX_FMT_RGB24</constant></entry>
 814             <entry>'RGB3'</entry>
 815             <entry></entry>
 816             <entry>r<subscript>7</subscript></entry>
 817             <entry>r<subscript>6</subscript></entry>
 818             <entry>r<subscript>5</subscript></entry>
 819             <entry>r<subscript>4</subscript></entry>
 820             <entry>r<subscript>3</subscript></entry>
 821             <entry>r<subscript>2</subscript></entry>
 822             <entry>r<subscript>1</subscript></entry>
 823             <entry>r<subscript>0</subscript></entry>
 824             <entry></entry>
 825             <entry>g<subscript>7</subscript></entry>
 826             <entry>g<subscript>6</subscript></entry>
 827             <entry>g<subscript>5</subscript></entry>
 828             <entry>g<subscript>4</subscript></entry>
 829             <entry>g<subscript>3</subscript></entry>
 830             <entry>g<subscript>2</subscript></entry>
 831             <entry>g<subscript>1</subscript></entry>
 832             <entry>g<subscript>0</subscript></entry>
 833             <entry></entry>
 834             <entry>b<subscript>7</subscript></entry>
 835             <entry>b<subscript>6</subscript></entry>
 836             <entry>b<subscript>5</subscript></entry>
 837             <entry>b<subscript>4</subscript></entry>
 838             <entry>b<subscript>3</subscript></entry>
 839             <entry>b<subscript>2</subscript></entry>
 840             <entry>b<subscript>1</subscript></entry>
 841             <entry>b<subscript>0</subscript></entry>
 842           </row>
 843           <row><!-- id="V4L2-PIX-FMT-BGR32" -->
 844             <entry><constant>V4L2_PIX_FMT_BGR32</constant></entry>
 845             <entry>'BGR4'</entry>
 846             <entry></entry>
 847             <entry>b<subscript>7</subscript></entry>
 848             <entry>b<subscript>6</subscript></entry>
 849             <entry>b<subscript>5</subscript></entry>
 850             <entry>b<subscript>4</subscript></entry>
 851             <entry>b<subscript>3</subscript></entry>
 852             <entry>b<subscript>2</subscript></entry>
 853             <entry>b<subscript>1</subscript></entry>
 854             <entry>b<subscript>0</subscript></entry>
 855             <entry></entry>
 856             <entry>g<subscript>7</subscript></entry>
 857             <entry>g<subscript>6</subscript></entry>
 858             <entry>g<subscript>5</subscript></entry>
 859             <entry>g<subscript>4</subscript></entry>
 860             <entry>g<subscript>3</subscript></entry>
 861             <entry>g<subscript>2</subscript></entry>
 862             <entry>g<subscript>1</subscript></entry>
 863             <entry>g<subscript>0</subscript></entry>
 864             <entry></entry>
 865             <entry>r<subscript>7</subscript></entry>
 866             <entry>r<subscript>6</subscript></entry>
 867             <entry>r<subscript>5</subscript></entry>
 868             <entry>r<subscript>4</subscript></entry>
 869             <entry>r<subscript>3</subscript></entry>
 870             <entry>r<subscript>2</subscript></entry>
 871             <entry>r<subscript>1</subscript></entry>
 872             <entry>r<subscript>0</subscript></entry>
 873             <entry></entry>
 874             <entry>a<subscript>7</subscript></entry>
 875             <entry>a<subscript>6</subscript></entry>
 876             <entry>a<subscript>5</subscript></entry>
 877             <entry>a<subscript>4</subscript></entry>
 878             <entry>a<subscript>3</subscript></entry>
 879             <entry>a<subscript>2</subscript></entry>
 880             <entry>a<subscript>1</subscript></entry>
 881             <entry>a<subscript>0</subscript></entry>
 882           </row>
 883           <row><!-- id="V4L2-PIX-FMT-RGB32" -->
 884             <entry><constant>V4L2_PIX_FMT_RGB32</constant></entry>
 885             <entry>'RGB4'</entry>
 886             <entry></entry>
 887             <entry>a<subscript>7</subscript></entry>
 888             <entry>a<subscript>6</subscript></entry>
 889             <entry>a<subscript>5</subscript></entry>
 890             <entry>a<subscript>4</subscript></entry>
 891             <entry>a<subscript>3</subscript></entry>
 892             <entry>a<subscript>2</subscript></entry>
 893             <entry>a<subscript>1</subscript></entry>
 894             <entry>a<subscript>0</subscript></entry>
 895             <entry></entry>
 896             <entry>r<subscript>7</subscript></entry>
 897             <entry>r<subscript>6</subscript></entry>
 898             <entry>r<subscript>5</subscript></entry>
 899             <entry>r<subscript>4</subscript></entry>
 900             <entry>r<subscript>3</subscript></entry>
 901             <entry>r<subscript>2</subscript></entry>
 902             <entry>r<subscript>1</subscript></entry>
 903             <entry>r<subscript>0</subscript></entry>
 904             <entry></entry>
 905             <entry>g<subscript>7</subscript></entry>
 906             <entry>g<subscript>6</subscript></entry>
 907             <entry>g<subscript>5</subscript></entry>
 908             <entry>g<subscript>4</subscript></entry>
 909             <entry>g<subscript>3</subscript></entry>
 910             <entry>g<subscript>2</subscript></entry>
 911             <entry>g<subscript>1</subscript></entry>
 912             <entry>g<subscript>0</subscript></entry>
 913             <entry></entry>
 914             <entry>b<subscript>7</subscript></entry>
 915             <entry>b<subscript>6</subscript></entry>
 916             <entry>b<subscript>5</subscript></entry>
 917             <entry>b<subscript>4</subscript></entry>
 918             <entry>b<subscript>3</subscript></entry>
 919             <entry>b<subscript>2</subscript></entry>
 920             <entry>b<subscript>1</subscript></entry>
 921             <entry>b<subscript>0</subscript></entry>
 922           </row>
 923         </tbody>
 924       </tgroup>
 925     </table>
 926
 927     <para>A test utility to determine which RGB formats a driver
 928 actually supports is available from the LinuxTV v4l-dvb repository.
 929 See &v4l-dvb; for access instructions.</para>
 930
 931   </refsect1>
 932     </refentry>
 933
 934   <!--
 935 Local Variables:
 936 mode: sgml
 937 sgml-parent-document: "pixfmt.sgml"
 938 indent-tabs-mode: nil
 939 End:
 940   -->