^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-YVU420:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _V4L2-PIX-FMT-YUV420:
^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_YVU420 ('YV12'), V4L2_PIX_FMT_YUV420 ('YU12')
^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_YUV420
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Planar formats with ½ horizontal and vertical chroma resolution, also
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) known as YUV 4:2:0
^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) These are planar formats, 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. The Y plane
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) is first. The Y plane has one byte per pixel. For
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) ``V4L2_PIX_FMT_YVU420``, the Cr plane immediately follows the Y plane in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) memory. The Cr plane is half the width and half the height of the Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) plane (and of the image). Each Cr belongs to four pixels, a two-by-two
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) square of the image. For example, Cr\ :sub:`0` belongs to Y'\ :sub:`00`,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Y'\ :sub:`01`, Y'\ :sub:`10`, and Y'\ :sub:`11`. Following the Cr plane
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) is the Cb plane, just like the Cr plane. ``V4L2_PIX_FMT_YUV420`` is the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) same except the Cb plane comes first, then the Cr 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 Cr and Cb planes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) have half as many pad bytes after their rows. In other words, two Cx
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) rows (including padding) is exactly as long as one Y row (including
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) padding).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) **Byte Order.**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Each cell is one byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^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) * - start + 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) * - start + 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) * - start + 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) * - start + 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) * - start + 16:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - Cr\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) * - start + 18:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Cr\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) * - start + 20:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - Cb\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) * - start + 22:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) - Cb\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) **Color Sample Location:**
^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)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) * - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - C
^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) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) * - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) - Y