1.. -*- coding: utf-8; mode: rst -*-
2
3.. _V4L2-PIX-FMT-YVU410:
4.. _v4l2-pix-fmt-yuv410:
5
6**********************************************************
7V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9')
8**********************************************************
9
10
11V4L2_PIX_FMT_YUV410
12Planar formats with ¼ horizontal and vertical chroma resolution, also
13known as YUV 4:1:0
14
15
16Description
17===========
18
19These are planar formats, as opposed to a packed format. The three
20components are separated into three sub-images or planes. The Y plane is
21first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
22the 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
24belongs to 16 pixels, a four-by-four square of the image. Following the
25Cr plane is the Cb plane, just like the Cr plane.
26``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
27then the Cr plane.
28
29If the Y plane has pad bytes after each row, then the Cr and Cb planes
30have ¼ 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
32padding).
33
34**Byte Order.**
35Each 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
128