^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-NV12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _V4L2-PIX-FMT-NV21:
^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_NV12 ('NV12'), V4L2_PIX_FMT_NV21 ('NV21')
^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_NV21
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Formats with ½ horizontal and vertical chroma resolution, also known as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) YUV 4:2:0. One luminance and one chrominance plane with alternating
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) chroma samples as opposed to ``V4L2_PIX_FMT_YVU420``
^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) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) These are two-plane versions of the YUV 4:2:0 format. The three
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) components are separated into two sub-images or planes. The Y plane is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV12``, a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) combined CbCr plane immediately follows the Y plane in memory. The CbCr
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) plane is the same width, in bytes, as the Y plane (and of the image),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) but is half as tall in pixels. Each CbCr pair belongs to four pixels.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) For example, Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Y'\ :sub:`01`, Y'\ :sub:`10`, Y'\ :sub:`11`. ``V4L2_PIX_FMT_NV21`` is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) the same except the Cb and Cr bytes are swapped, the CrCb plane starts
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) with a Cr byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) If the Y plane has pad bytes after each row, then the CbCr plane has as
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) many pad bytes after its rows.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) **Byte Order.**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Each cell is one byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) * - start + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) - Y'\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) - Y'\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) - Y'\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - Y'\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) * - start + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) - Y'\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) - Y'\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) - Y'\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) - Y'\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) * - start + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) - Y'\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Y'\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) - Y'\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) - Y'\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) * - start + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) - Y'\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - Y'\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) - Y'\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) - Y'\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) * - start + 16:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) - Cb\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) - Cr\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) * - start + 20:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Cb\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) - Cr\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) **Color Sample Location:**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) :stub-columns: 0
^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) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) * - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) - C
^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) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) * - 1
^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) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) - Y
^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) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) - Y
^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) - Y