Merge branch 'v4l_for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab...
[linux-2.6.git] / 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>