GNU Linux-libre 4.14.295-gnu1
[releases.git] / Documentation / media / uapi / v4l / pixfmt-yuv410.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _V4L2-PIX-FMT-YVU410:
4 .. _v4l2-pix-fmt-yuv410:
5
6 **********************************************************
7 V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9')
8 **********************************************************
9
10
11 V4L2_PIX_FMT_YUV410
12 Planar formats with ¼ horizontal and vertical chroma resolution, also
13 known as YUV 4:1:0
14
15
16 Description
17 ===========
18
19 These are planar formats, as opposed to a packed format. The three
20 components are separated into three sub-images or planes. The Y plane is
21 first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
22 the Cr plane immediately follows the Y plane in memory. The Cr plane is
23 ¼ the width and ¼ the height of the Y plane (and of the image). Each Cr
24 belongs to 16 pixels, a four-by-four square of the image. Following the
25 Cr plane is the Cb plane, just like the Cr plane.
26 ``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
27 then the Cr plane.
28
29 If the Y plane has pad bytes after each row, then the Cr and Cb planes
30 have ¼ as many pad bytes after their rows. In other words, four Cx rows
31 (including padding) are exactly as long as one Y row (including
32 padding).
33
34 **Byte Order.**
35 Each cell is one byte.
36
37
38
39
40 .. flat-table::
41     :header-rows:  0
42     :stub-columns: 0
43
44     * - start + 0:
45       - Y'\ :sub:`00`
46       - Y'\ :sub:`01`
47       - Y'\ :sub:`02`
48       - Y'\ :sub:`03`
49     * - start + 4:
50       - Y'\ :sub:`10`
51       - Y'\ :sub:`11`
52       - Y'\ :sub:`12`
53       - Y'\ :sub:`13`
54     * - start + 8:
55       - Y'\ :sub:`20`
56       - Y'\ :sub:`21`
57       - Y'\ :sub:`22`
58       - Y'\ :sub:`23`
59     * - start + 12:
60       - Y'\ :sub:`30`
61       - Y'\ :sub:`31`
62       - Y'\ :sub:`32`
63       - Y'\ :sub:`33`
64     * - start + 16:
65       - Cr\ :sub:`00`
66     * - start + 17:
67       - Cb\ :sub:`00`
68
69
70 **Color Sample Location:**
71
72
73
74 .. flat-table::
75     :header-rows:  0
76     :stub-columns: 0
77
78     * -
79       - 0
80       -
81       - 1
82       -
83       - 2
84       -
85       - 3
86     * - 0
87       - Y
88       -
89       - Y
90       -
91       - Y
92       -
93       - Y
94     * -
95     * - 1
96       - Y
97       -
98       - Y
99       -
100       - Y
101       -
102       - Y
103     * -
104       -
105       -
106       -
107       - C
108       -
109       -
110       -
111     * - 2
112       - Y
113       -
114       - Y
115       -
116       - Y
117       -
118       - Y
119     * -
120     * - 3
121       - Y
122       -
123       - Y
124       -
125       - Y
126       -
127       - Y