^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-YUV444M:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _v4l2-pix-fmt-yvu444m:
^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_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42')
^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_YVU444M
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Planar formats with full horizontal resolution, also known as YUV and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) YVU 4:4:4
^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_YUV444M`` the Cb data constitutes the second plane which
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) is the same width and height as the Y plane (and as the image). The Cr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) data, just like the Cb plane, is in the third plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) ``V4L2_PIX_FMT_YVU444M`` is the same except the Cr data is stored in the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) second plane and the Cb data in the third plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 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 31) have the same number of pad bytes after their rows.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) ``V4L2_PIX_FMT_YUV444M`` and ``V4L2_PIX_FMT_YUV444M`` are intended to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) used only in drivers and applications that support the multi-planar API,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) described in :ref:`planar-apis`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) **Byte Order.**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Each cell is one byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) * - start0 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - Y'\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) - Y'\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) - Y'\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) - Y'\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) * - start0 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) - Y'\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - Y'\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - Y'\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Y'\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) * - start0 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) - Y'\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - Y'\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - Y'\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - Y'\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) * - start0 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) - Y'\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) - Y'\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) - Y'\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) - Y'\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) * - start1 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) - Cb\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) - Cb\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Cb\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) * - start1 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - Cb\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) - Cb\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - Cb\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) * - start1 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) - Cb\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) - Cb\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) - Cb\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) - Cb\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) * - start1 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) - Cb\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) - Cb\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) - Cb\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) - Cb\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) * - start2 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) - Cr\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - Cr\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - Cr\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) * - start2 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - Cr\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) - Cr\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - Cr\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) * - start2 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) - Cr\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) - Cr\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - Cr\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) - Cr\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) * - start2 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) - Cr\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) - Cr\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - Cr\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) - Cr\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) **Color Sample Location:**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) * - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) * - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) - YC
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) - YC