^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-YUV422M:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _v4l2-pix-fmt-yvu422m:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) ************************************************************
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) V4L2_PIX_FMT_YUV422M ('YM16'), V4L2_PIX_FMT_YVU422M ('YM61')
^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)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) V4L2_PIX_FMT_YVU422M
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Planar formats with ½ horizontal resolution, also known as YUV and YVU
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 4:2:2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) This is a multi-planar format, as opposed to a packed format. The three
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) components are separated into three sub-images or planes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) The Y plane is first. The Y plane has one byte per pixel. For
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) ``V4L2_PIX_FMT_YUV422M`` the Cb data constitutes the second plane which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) is half the width of the Y plane (and of the image). Each Cb belongs to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) two pixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Y'\ :sub:`01`. The Cr data, just like the Cb plane, is in the third
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) ``V4L2_PIX_FMT_YVU422M`` is the same except the Cr data is stored in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) second plane and the Cb data in the third plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) If the Y plane has pad bytes after each row, then the Cb and Cr planes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) have half as many pad bytes after their rows. In other words, two Cx
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) rows (including padding) is exactly as long as one Y row (including
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) padding).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) ``V4L2_PIX_FMT_YUV422M`` and ``V4L2_PIX_FMT_YVU422M`` are intended to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) used only in drivers and applications that support the multi-planar API,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) described in :ref:`planar-apis`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) **Byte Order.**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Each cell is one byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) * - start0 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - Y'\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - Y'\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Y'\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) - Y'\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) * - start0 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - Y'\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - Y'\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - Y'\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) - Y'\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) * - start0 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) - Y'\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) - Y'\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) - Y'\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) - Y'\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) * - start0 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - Y'\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) - Y'\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) - Y'\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Y'\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) * - start1 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) - Cb\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) * - start1 + 2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) - Cb\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) * - start1 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) - Cb\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) - Cb\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) * - start1 + 6:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) - Cb\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) - Cb\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) * - start2 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) - Cr\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) * - start2 + 2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - Cr\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) * - start2 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) - Cr\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) - Cr\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) * - start2 + 6:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) - Cr\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - Cr\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) **Color Sample Location:**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) * - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) * - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) - Y