Documentation/DocBook/media/v4l/pixfmt-packed-yuv.xml

   1 <refentry id="packed-yuv">
   2   <refmeta>
   3     <refentrytitle>Packed YUV formats</refentrytitle>
   4     &manvol;
   5   </refmeta>
   6   <refnamediv>
   7     <refname>Packed YUV formats</refname>
   8     <refpurpose>Packed YUV formats</refpurpose>
   9   </refnamediv>
  10   <refsect1>
  11     <title>Description</title>
  12
  13     <para>Similar to the packed RGB formats these formats store
  14 the Y, Cb and Cr component of each pixel in one 16 or 32 bit
  15 word.</para>
  16
  17     <table pgwide="1" frame="none">
  18       <title>Packed YUV Image Formats</title>
  19       <tgroup cols="37" align="center">
  20         <colspec colname="id" align="left" />
  21         <colspec colname="fourcc" />
  22         <colspec colname="bit" />
  23
  24         <colspec colnum="4" colname="b07" align="center" />
  25         <colspec colnum="5" colname="b06" align="center" />
  26         <colspec colnum="6" colname="b05" align="center" />
  27         <colspec colnum="7" colname="b04" align="center" />
  28         <colspec colnum="8" colname="b03" align="center" />
  29         <colspec colnum="9" colname="b02" align="center" />
  30         <colspec colnum="10" colname="b01" align="center" />
  31         <colspec colnum="11" colname="b00" align="center" />
  32
  33         <colspec colnum="13" colname="b17" align="center" />
  34         <colspec colnum="14" colname="b16" align="center" />
  35         <colspec colnum="15" colname="b15" align="center" />
  36         <colspec colnum="16" colname="b14" align="center" />
  37         <colspec colnum="17" colname="b13" align="center" />
  38         <colspec colnum="18" colname="b12" align="center" />
  39         <colspec colnum="19" colname="b11" align="center" />
  40         <colspec colnum="20" colname="b10" align="center" />
  41
  42         <colspec colnum="22" colname="b27" align="center" />
  43         <colspec colnum="23" colname="b26" align="center" />
  44         <colspec colnum="24" colname="b25" align="center" />
  45         <colspec colnum="25" colname="b24" align="center" />
  46         <colspec colnum="26" colname="b23" align="center" />
  47         <colspec colnum="27" colname="b22" align="center" />
  48         <colspec colnum="28" colname="b21" align="center" />
  49         <colspec colnum="29" colname="b20" align="center" />
  50
  51         <colspec colnum="31" colname="b37" align="center" />
  52         <colspec colnum="32" colname="b36" align="center" />
  53         <colspec colnum="33" colname="b35" align="center" />
  54         <colspec colnum="34" colname="b34" align="center" />
  55         <colspec colnum="35" colname="b33" align="center" />
  56         <colspec colnum="36" colname="b32" align="center" />
  57         <colspec colnum="37" colname="b31" align="center" />
  58         <colspec colnum="38" colname="b30" align="center" />
  59
  60         <spanspec namest="b07" nameend="b00" spanname="b0" />
  61         <spanspec namest="b17" nameend="b10" spanname="b1" />
  62         <spanspec namest="b27" nameend="b20" spanname="b2" />
  63         <spanspec namest="b37" nameend="b30" spanname="b3" />
  64         <thead>
  65           <row>
  66             <entry>Identifier</entry>
  67             <entry>Code</entry>
  68             <entry>&nbsp;</entry>
  69             <entry spanname="b0">Byte&nbsp;0 in memory</entry>
  70             <entry spanname="b1">Byte&nbsp;1</entry>
  71             <entry spanname="b2">Byte&nbsp;2</entry>
  72             <entry spanname="b3">Byte&nbsp;3</entry>
  73           </row>
  74           <row>
  75             <entry>&nbsp;</entry>
  76             <entry>&nbsp;</entry>
  77             <entry>Bit</entry>
  78             <entry>7</entry>
  79             <entry>6</entry>
  80             <entry>5</entry>
  81             <entry>4</entry>
  82             <entry>3</entry>
  83             <entry>2</entry>
  84             <entry>1</entry>
  85             <entry>0</entry>
  86             <entry>&nbsp;</entry>
  87             <entry>7</entry>
  88             <entry>6</entry>
  89             <entry>5</entry>
  90             <entry>4</entry>
  91             <entry>3</entry>
  92             <entry>2</entry>
  93             <entry>1</entry>
  94             <entry>0</entry>
  95             <entry>&nbsp;</entry>
  96             <entry>7</entry>
  97             <entry>6</entry>
  98             <entry>5</entry>
  99             <entry>4</entry>
 100             <entry>3</entry>
 101             <entry>2</entry>
 102             <entry>1</entry>
 103             <entry>0</entry>
 104             <entry>&nbsp;</entry>
 105             <entry>7</entry>
 106             <entry>6</entry>
 107             <entry>5</entry>
 108             <entry>4</entry>
 109             <entry>3</entry>
 110             <entry>2</entry>
 111             <entry>1</entry>
 112             <entry>0</entry>
 113           </row>
 114         </thead>
 115         <tbody valign="top">
 116           <row id="V4L2-PIX-FMT-YUV444">
 117             <entry><constant>V4L2_PIX_FMT_YUV444</constant></entry>
 118             <entry>'Y444'</entry>
 119             <entry></entry>
 120             <entry>Cb<subscript>3</subscript></entry>
 121             <entry>Cb<subscript>2</subscript></entry>
 122             <entry>Cb<subscript>1</subscript></entry>
 123             <entry>Cb<subscript>0</subscript></entry>
 124             <entry>Cr<subscript>3</subscript></entry>
 125             <entry>Cr<subscript>2</subscript></entry>
 126             <entry>Cr<subscript>1</subscript></entry>
 127             <entry>Cr<subscript>0</subscript></entry>
 128             <entry></entry>
 129             <entry>a<subscript>3</subscript></entry>
 130             <entry>a<subscript>2</subscript></entry>
 131             <entry>a<subscript>1</subscript></entry>
 132             <entry>a<subscript>0</subscript></entry>
 133             <entry>Y'<subscript>3</subscript></entry>
 134             <entry>Y'<subscript>2</subscript></entry>
 135             <entry>Y'<subscript>1</subscript></entry>
 136             <entry>Y'<subscript>0</subscript></entry>
 137           </row>
 138
 139           <row id="V4L2-PIX-FMT-YUV555">
 140             <entry><constant>V4L2_PIX_FMT_YUV555</constant></entry>
 141             <entry>'YUVO'</entry>
 142             <entry></entry>
 143             <entry>Cb<subscript>2</subscript></entry>
 144             <entry>Cb<subscript>1</subscript></entry>
 145             <entry>Cb<subscript>0</subscript></entry>
 146             <entry>Cr<subscript>4</subscript></entry>
 147             <entry>Cr<subscript>3</subscript></entry>
 148             <entry>Cr<subscript>2</subscript></entry>
 149             <entry>Cr<subscript>1</subscript></entry>
 150             <entry>Cr<subscript>0</subscript></entry>
 151             <entry></entry>
 152             <entry>a</entry>
 153             <entry>Y'<subscript>4</subscript></entry>
 154             <entry>Y'<subscript>3</subscript></entry>
 155             <entry>Y'<subscript>2</subscript></entry>
 156             <entry>Y'<subscript>1</subscript></entry>
 157             <entry>Y'<subscript>0</subscript></entry>
 158             <entry>Cb<subscript>4</subscript></entry>
 159             <entry>Cb<subscript>3</subscript></entry>
 160           </row>
 161
 162           <row id="V4L2-PIX-FMT-YUV565">
 163             <entry><constant>V4L2_PIX_FMT_YUV565</constant></entry>
 164             <entry>'YUVP'</entry>
 165             <entry></entry>
 166             <entry>Cb<subscript>2</subscript></entry>
 167             <entry>Cb<subscript>1</subscript></entry>
 168             <entry>Cb<subscript>0</subscript></entry>
 169             <entry>Cr<subscript>4</subscript></entry>
 170             <entry>Cr<subscript>3</subscript></entry>
 171             <entry>Cr<subscript>2</subscript></entry>
 172             <entry>Cr<subscript>1</subscript></entry>
 173             <entry>Cr<subscript>0</subscript></entry>
 174             <entry></entry>
 175             <entry>Y'<subscript>4</subscript></entry>
 176             <entry>Y'<subscript>3</subscript></entry>
 177             <entry>Y'<subscript>2</subscript></entry>
 178             <entry>Y'<subscript>1</subscript></entry>
 179             <entry>Y'<subscript>0</subscript></entry>
 180             <entry>Cb<subscript>5</subscript></entry>
 181             <entry>Cb<subscript>4</subscript></entry>
 182             <entry>Cb<subscript>3</subscript></entry>
 183           </row>
 184
 185           <row id="V4L2-PIX-FMT-YUV32">
 186             <entry><constant>V4L2_PIX_FMT_YUV32</constant></entry>
 187             <entry>'YUV4'</entry>
 188             <entry></entry>
 189             <entry>a<subscript>7</subscript></entry>
 190             <entry>a<subscript>6</subscript></entry>
 191             <entry>a<subscript>5</subscript></entry>
 192             <entry>a<subscript>4</subscript></entry>
 193             <entry>a<subscript>3</subscript></entry>
 194             <entry>a<subscript>2</subscript></entry>
 195             <entry>a<subscript>1</subscript></entry>
 196             <entry>a<subscript>0</subscript></entry>
 197             <entry></entry>
 198             <entry>Y'<subscript>7</subscript></entry>
 199             <entry>Y'<subscript>6</subscript></entry>
 200             <entry>Y'<subscript>5</subscript></entry>
 201             <entry>Y'<subscript>4</subscript></entry>
 202             <entry>Y'<subscript>3</subscript></entry>
 203             <entry>Y'<subscript>2</subscript></entry>
 204             <entry>Y'<subscript>1</subscript></entry>
 205             <entry>Y'<subscript>0</subscript></entry>
 206             <entry></entry>
 207             <entry>Cb<subscript>7</subscript></entry>
 208             <entry>Cb<subscript>6</subscript></entry>
 209             <entry>Cb<subscript>5</subscript></entry>
 210             <entry>Cb<subscript>4</subscript></entry>
 211             <entry>Cb<subscript>3</subscript></entry>
 212             <entry>Cb<subscript>2</subscript></entry>
 213             <entry>Cb<subscript>1</subscript></entry>
 214             <entry>Cb<subscript>0</subscript></entry>
 215             <entry></entry>
 216             <entry>Cr<subscript>7</subscript></entry>
 217             <entry>Cr<subscript>6</subscript></entry>
 218             <entry>Cr<subscript>5</subscript></entry>
 219             <entry>Cr<subscript>4</subscript></entry>
 220             <entry>Cr<subscript>3</subscript></entry>
 221             <entry>Cr<subscript>2</subscript></entry>
 222             <entry>Cr<subscript>1</subscript></entry>
 223             <entry>Cr<subscript>0</subscript></entry>
 224           </row>
 225         </tbody>
 226       </tgroup>
 227     </table>
 228
 229     <para>Bit 7 is the most significant bit. The value of a = alpha
 230 bits is undefined when reading from the driver, ignored when writing
 231 to the driver, except when alpha blending has been negotiated for a
 232 <link linkend="overlay">Video Overlay</link> or <link
 233 linkend="osd">Video Output Overlay</link>.</para>
 234
 235   </refsect1>
 236     </refentry>