Merge tag 'pci-v4.21-changes' of git://git.kernel.org/pub/scm/linux/kernel/git/helgaa...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / v4l / pixfmt-yvyu.rst
1 .. Permission is granted to copy, distribute and/or modify this
2 .. document under the terms of the GNU Free Documentation License,
3 .. Version 1.1 or any later version published by the Free Software
4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
5 .. and no Back-Cover Texts. A copy of the license is included at
6 .. Documentation/media/uapi/fdl-appendix.rst.
7 ..
8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10 .. _V4L2-PIX-FMT-YVYU:
11
12 **************************
13 V4L2_PIX_FMT_YVYU ('YVYU')
14 **************************
15
16
17 Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in
18 memory
19
20
21 Description
22 ===========
23
24 In this format each four bytes is two pixels. Each four bytes is two
25 Y's, a Cb and a Cr. Each Y goes to one of the pixels, and the Cb and Cr
26 belong to both pixels. As you can see, the Cr and Cb components have
27 half the horizontal resolution of the Y component.
28
29 **Byte Order.**
30 Each cell is one byte.
31
32
33 .. flat-table::
34     :header-rows:  0
35     :stub-columns: 0
36
37     * - start + 0:
38       - Y'\ :sub:`00`
39       - Cr\ :sub:`00`
40       - Y'\ :sub:`01`
41       - Cb\ :sub:`00`
42       - Y'\ :sub:`02`
43       - Cr\ :sub:`01`
44       - Y'\ :sub:`03`
45       - Cb\ :sub:`01`
46     * - start + 8:
47       - Y'\ :sub:`10`
48       - Cr\ :sub:`10`
49       - Y'\ :sub:`11`
50       - Cb\ :sub:`10`
51       - Y'\ :sub:`12`
52       - Cr\ :sub:`11`
53       - Y'\ :sub:`13`
54       - Cb\ :sub:`11`
55     * - start + 16:
56       - Y'\ :sub:`20`
57       - Cr\ :sub:`20`
58       - Y'\ :sub:`21`
59       - Cb\ :sub:`20`
60       - Y'\ :sub:`22`
61       - Cr\ :sub:`21`
62       - Y'\ :sub:`23`
63       - Cb\ :sub:`21`
64     * - start + 24:
65       - Y'\ :sub:`30`
66       - Cr\ :sub:`30`
67       - Y'\ :sub:`31`
68       - Cb\ :sub:`30`
69       - Y'\ :sub:`32`
70       - Cr\ :sub:`31`
71       - Y'\ :sub:`33`
72       - Cb\ :sub:`31`
73
74
75 **Color Sample Location:**
76
77 .. flat-table::
78     :header-rows:  0
79     :stub-columns: 0
80
81     * -
82       - 0
83       -
84       - 1
85       - 2
86       -
87       - 3
88     * - 0
89       - Y
90       - C
91       - Y
92       - Y
93       - C
94       - Y
95     * - 1
96       - Y
97       - C
98       - Y
99       - Y
100       - C
101       - Y
102     * - 2
103       - Y
104       - C
105       - Y
106       - Y
107       - C
108       - Y
109     * - 3
110       - Y
111       - C
112       - Y
113       - Y
114       - C
115       - Y