GNU Linux-libre 4.14.295-gnu1
[releases.git] / Documentation / media / uapi / v4l / pixfmt-yuv444m.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _V4L2-PIX-FMT-YUV444M:
4 .. _v4l2-pix-fmt-yvu444m:
5
6 ************************************************************
7 V4L2_PIX_FMT_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42')
8 ************************************************************
9
10
11 V4L2_PIX_FMT_YVU444M
12 Planar formats with full horizontal resolution, also known as YUV and
13 YVU 4:4:4
14
15
16 Description
17 ===========
18
19 This is a multi-planar format, as opposed to a packed format. The three
20 components are separated into three sub-images or planes.
21
22 The Y plane is first. The Y plane has one byte per pixel. For
23 ``V4L2_PIX_FMT_YUV444M`` the Cb data constitutes the second plane which
24 is the same width and height as the Y plane (and as the image). The Cr
25 data, just like the Cb plane, is in the third plane.
26
27 ``V4L2_PIX_FMT_YVU444M`` is the same except the Cr data is stored in the
28 second plane and the Cb data in the third plane.
29
30 If the Y plane has pad bytes after each row, then the Cb and Cr planes
31 have the same number of pad bytes after their rows.
32
33 ``V4L2_PIX_FMT_YUV444M`` and ``V4L2_PIX_FMT_YUV444M`` are intended to be
34 used only in drivers and applications that support the multi-planar API,
35 described in :ref:`planar-apis`.
36
37 **Byte Order.**
38 Each cell is one byte.
39
40
41 .. flat-table::
42     :header-rows:  0
43     :stub-columns: 0
44
45     * - start0 + 0:
46       - Y'\ :sub:`00`
47       - Y'\ :sub:`01`
48       - Y'\ :sub:`02`
49       - Y'\ :sub:`03`
50     * - start0 + 4:
51       - Y'\ :sub:`10`
52       - Y'\ :sub:`11`
53       - Y'\ :sub:`12`
54       - Y'\ :sub:`13`
55     * - start0 + 8:
56       - Y'\ :sub:`20`
57       - Y'\ :sub:`21`
58       - Y'\ :sub:`22`
59       - Y'\ :sub:`23`
60     * - start0 + 12:
61       - Y'\ :sub:`30`
62       - Y'\ :sub:`31`
63       - Y'\ :sub:`32`
64       - Y'\ :sub:`33`
65     * -
66     * - start1 + 0:
67       - Cb\ :sub:`00`
68       - Cb\ :sub:`01`
69       - Cb\ :sub:`02`
70       - Cb\ :sub:`03`
71     * - start1 + 4:
72       - Cb\ :sub:`10`
73       - Cb\ :sub:`11`
74       - Cb\ :sub:`12`
75       - Cb\ :sub:`13`
76     * - start1 + 8:
77       - Cb\ :sub:`20`
78       - Cb\ :sub:`21`
79       - Cb\ :sub:`22`
80       - Cb\ :sub:`23`
81     * - start1 + 12:
82       - Cb\ :sub:`20`
83       - Cb\ :sub:`21`
84       - Cb\ :sub:`32`
85       - Cb\ :sub:`33`
86     * -
87     * - start2 + 0:
88       - Cr\ :sub:`00`
89       - Cr\ :sub:`01`
90       - Cr\ :sub:`02`
91       - Cr\ :sub:`03`
92     * - start2 + 4:
93       - Cr\ :sub:`10`
94       - Cr\ :sub:`11`
95       - Cr\ :sub:`12`
96       - Cr\ :sub:`13`
97     * - start2 + 8:
98       - Cr\ :sub:`20`
99       - Cr\ :sub:`21`
100       - Cr\ :sub:`22`
101       - Cr\ :sub:`23`
102     * - start2 + 12:
103       - Cr\ :sub:`30`
104       - Cr\ :sub:`31`
105       - Cr\ :sub:`32`
106       - Cr\ :sub:`33`
107
108
109 **Color Sample Location:**
110
111
112
113 .. flat-table::
114     :header-rows:  0
115     :stub-columns: 0
116
117     * -
118       - 0
119       - 1
120       - 2
121       - 3
122     * - 0
123       - YC
124       - YC
125       - YC
126       - YC
127     * - 1
128       - YC
129       - YC
130       - YC
131       - YC
132     * - 2
133       - YC
134       - YC
135       - YC
136       - YC
137     * - 3
138       - YC
139       - YC
140       - YC
141       - YC