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
14the Y, Cb and Cr component of each pixel in one 16 or 32 bit
15word.</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
230bits is undefined when reading from the driver, ignored when writing
231to the driver, except when alpha blending has been negotiated for a
232<link linkend="overlay">Video Overlay</link> or <link
233linkend="osd">Video Output Overlay</link>.</para>
234
235  </refsect1>
236    </refentry>
237