include: replace linux/module.h with "struct module" wherever possible
[linux-2.6/next.git] / Documentation / DocBook / media / v4l / pixfmt-yvyu.xml
blob40d17ae39dde0cd399c54d35d96cccce25149f4b
1     <refentry id="V4L2-PIX-FMT-YVYU">
2       <refmeta>
3         <refentrytitle>V4L2_PIX_FMT_YVYU ('YVYU')</refentrytitle>
4         &manvol;
5       </refmeta>
6       <refnamediv>
7         <refname><constant>V4L2_PIX_FMT_YVYU</constant></refname>
8         <refpurpose>Variation of
9 <constant>V4L2_PIX_FMT_YUYV</constant> with different order of samples
10 in memory</refpurpose>
11       </refnamediv>
12       <refsect1>
13         <title>Description</title>
15         <para>In this format each four bytes is two pixels. Each four
16 bytes is two Y's, a Cb and a Cr. Each Y goes to one of the pixels, and
17 the Cb and Cr belong to both pixels. As you can see, the Cr and Cb
18 components have half the horizontal resolution of the Y
19 component.</para>
21         <example>
22           <title><constant>V4L2_PIX_FMT_YVYU</constant> 4 &times; 4
23 pixel image</title>
25           <formalpara>
26             <title>Byte Order.</title>
27             <para>Each cell is one byte.
28                 <informaltable frame="none">
29                 <tgroup cols="9" align="center">
30                   <colspec align="left" colwidth="2*" />
31                   <tbody valign="top">
32                     <row>
33                       <entry>start&nbsp;+&nbsp;0:</entry>
34                       <entry>Y'<subscript>00</subscript></entry>
35                       <entry>Cr<subscript>00</subscript></entry>
36                       <entry>Y'<subscript>01</subscript></entry>
37                       <entry>Cb<subscript>00</subscript></entry>
38                       <entry>Y'<subscript>02</subscript></entry>
39                       <entry>Cr<subscript>01</subscript></entry>
40                       <entry>Y'<subscript>03</subscript></entry>
41                       <entry>Cb<subscript>01</subscript></entry>
42                     </row>
43                     <row>
44                       <entry>start&nbsp;+&nbsp;8:</entry>
45                       <entry>Y'<subscript>10</subscript></entry>
46                       <entry>Cr<subscript>10</subscript></entry>
47                       <entry>Y'<subscript>11</subscript></entry>
48                       <entry>Cb<subscript>10</subscript></entry>
49                       <entry>Y'<subscript>12</subscript></entry>
50                       <entry>Cr<subscript>11</subscript></entry>
51                       <entry>Y'<subscript>13</subscript></entry>
52                       <entry>Cb<subscript>11</subscript></entry>
53                     </row>
54                     <row>
55                       <entry>start&nbsp;+&nbsp;16:</entry>
56                       <entry>Y'<subscript>20</subscript></entry>
57                       <entry>Cr<subscript>20</subscript></entry>
58                       <entry>Y'<subscript>21</subscript></entry>
59                       <entry>Cb<subscript>20</subscript></entry>
60                       <entry>Y'<subscript>22</subscript></entry>
61                       <entry>Cr<subscript>21</subscript></entry>
62                       <entry>Y'<subscript>23</subscript></entry>
63                       <entry>Cb<subscript>21</subscript></entry>
64                     </row>
65                     <row>
66                       <entry>start&nbsp;+&nbsp;24:</entry>
67                       <entry>Y'<subscript>30</subscript></entry>
68                       <entry>Cr<subscript>30</subscript></entry>
69                       <entry>Y'<subscript>31</subscript></entry>
70                       <entry>Cb<subscript>30</subscript></entry>
71                       <entry>Y'<subscript>32</subscript></entry>
72                       <entry>Cr<subscript>31</subscript></entry>
73                       <entry>Y'<subscript>33</subscript></entry>
74                       <entry>Cb<subscript>31</subscript></entry>
75                     </row>
76                   </tbody>
77                 </tgroup>
78                 </informaltable>
79               </para>
80           </formalpara>
82           <formalpara>
83             <title>Color Sample Location.</title>
84             <para>
85                 <informaltable frame="none">
86                 <tgroup cols="7" align="center">
87                   <tbody valign="top">
88                     <row>
89                       <entry></entry>
90                       <entry>0</entry><entry></entry><entry>1</entry><entry></entry>
91                       <entry>2</entry><entry></entry><entry>3</entry>
92                     </row>
93                     <row>
94                       <entry>0</entry>
95                       <entry>Y</entry><entry>C</entry><entry>Y</entry><entry></entry>
96                       <entry>Y</entry><entry>C</entry><entry>Y</entry>
97                     </row>
98                     <row>
99                       <entry>1</entry>
100                       <entry>Y</entry><entry>C</entry><entry>Y</entry><entry></entry>
101                       <entry>Y</entry><entry>C</entry><entry>Y</entry>
102                     </row>
103                     <row>
104                       <entry>2</entry>
105                       <entry>Y</entry><entry>C</entry><entry>Y</entry><entry></entry>
106                       <entry>Y</entry><entry>C</entry><entry>Y</entry>
107                     </row>
108                     <row>
109                       <entry>3</entry>
110                       <entry>Y</entry><entry>C</entry><entry>Y</entry><entry></entry>
111                       <entry>Y</entry><entry>C</entry><entry>Y</entry>
112                     </row>
113                   </tbody>
114                 </tgroup>
115                 </informaltable>
116               </para>
117           </formalpara>
118         </example>
119       </refsect1>
120     </refentry>
122   <!--
123 Local Variables:
124 mode: sgml
125 sgml-parent-document: "pixfmt.sgml"
126 indent-tabs-mode: nil
127 End:
128   -->