^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) .. _V4L2-PIX-FMT-YUV411P:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) *****************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) V4L2_PIX_FMT_YUV411P ('411P')
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) *****************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Planar layout as opposed to ``V4L2_PIX_FMT_Y41P``
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) This format is not commonly used. This is a planar format similar to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) 4:2:2 planar format except with half as many chroma. The three
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) components are separated into three sub-images or planes. The Y plane is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) first. The Y plane has one byte per pixel. The Cb plane immediately
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) follows the Y plane in memory. The Cb plane is ¼ the width of the Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) plane (and of the image). Each Cb belongs to 4 pixels all on the same
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) row. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Y'\ :sub:`02` and Y'\ :sub:`03`. Following the Cb plane is the Cr plane,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) just like the Cb plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) If the Y plane has pad bytes after each row, then the Cr and Cb planes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) have ¼ as many pad bytes after their rows. In other words, four C x rows
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) (including padding) is exactly as long as one Y row (including padding).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) **Byte Order.**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Each cell is one byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) * - start + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) - Y'\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) - Y'\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) - Y'\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) - Y'\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) * - start + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - Y'\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) - Y'\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) - Y'\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) - Y'\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) * - start + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) - Y'\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - Y'\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - Y'\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Y'\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) * - start + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) - Y'\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - Y'\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - Y'\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - Y'\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) * - start + 16:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) * - start + 17:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) * - start + 18:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) - Cb\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) * - start + 19:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - Cb\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) * - start + 20:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) * - start + 21:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) * - start + 22:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - Cr\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) * - start + 23:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - Cr\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) **Color Sample Location:**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) * - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) * - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) - Y