• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
3.. _V4L2-PIX-FMT-YUV444M:
4.. _v4l2-pix-fmt-yvu444m:
5
6************************************************************
7V4L2_PIX_FMT_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42')
8************************************************************
9
10
11V4L2_PIX_FMT_YVU444M
12Planar formats with full horizontal resolution, also known as YUV and
13YVU 4:4:4
14
15
16Description
17===========
18
19This is a multi-planar format, as opposed to a packed format. The three
20components are separated into three sub-images or planes.
21
22The 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
24is the same width and height as the Y plane (and as the image). The Cr
25data, 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
28second plane and the Cb data in the third plane.
29
30If the Y plane has pad bytes after each row, then the Cb and Cr planes
31have the same number of pad bytes after their rows.
32
33``V4L2_PIX_FMT_YUV444M`` and ``V4L2_PIX_FMT_YUV444M`` are intended to be
34used only in drivers and applications that support the multi-planar API,
35described in :ref:`planar-apis`.
36
37**Byte Order.**
38Each 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
142