^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-NV16M:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) .. _v4l2-pix-fmt-nv61m:
^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_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61')
^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) V4L2_PIX_FMT_NV61M
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Variation of ``V4L2_PIX_FMT_NV16`` and ``V4L2_PIX_FMT_NV61`` with planes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) non contiguous in memory.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) ===========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) This is a multi-planar, two-plane version of the YUV 4:2:2 format. The
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) three components are separated into two sub-images or planes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) ``V4L2_PIX_FMT_NV16M`` differs from ``V4L2_PIX_FMT_NV16`` in that the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) two planes are non-contiguous in memory, i.e. the chroma plane does not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) necessarily immediately follow the luma plane. The luminance data
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) occupies the first plane. The Y plane has one byte per pixel. In the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) second plane there is chrominance data with alternating chroma samples.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) The CbCr plane is the same width and height, in bytes, as the Y plane.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Each CbCr pair belongs to two pixels. For example,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) ``V4L2_PIX_FMT_NV61M`` is the same as ``V4L2_PIX_FMT_NV16M`` except the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Cb and Cr bytes are swapped, the CrCb plane starts with a Cr byte.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) ``V4L2_PIX_FMT_NV16M`` and ``V4L2_PIX_FMT_NV61M`` are intended to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) used only in drivers and applications that support the multi-planar API,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) described in :ref:`planar-apis`.
^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) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) * - start0 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) - Y'\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) - Y'\ :sub:`01`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) - Y'\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) - Y'\ :sub:`03`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) * - start0 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) - Y'\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) - Y'\ :sub:`11`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) - Y'\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) - Y'\ :sub:`13`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) * - start0 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) - Y'\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) - Y'\ :sub:`21`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) - Y'\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) - Y'\ :sub:`23`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) * - start0 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) - Y'\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) - Y'\ :sub:`31`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) - Y'\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) - Y'\ :sub:`33`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) * - start1 + 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) - Cb\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) - Cr\ :sub:`00`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) - Cb\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) - Cr\ :sub:`02`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) * - start1 + 4:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) - Cb\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) - Cr\ :sub:`10`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) - Cb\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - Cr\ :sub:`12`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) * - start1 + 8:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - Cb\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) - Cr\ :sub:`20`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) - Cb\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) - Cr\ :sub:`22`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) * - start1 + 12:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) - Cb\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) - Cr\ :sub:`30`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) - Cb\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) - Cr\ :sub:`32`
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) **Color Sample Location:**
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) .. flat-table::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) :header-rows: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) :stub-columns: 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) - 0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) - 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) * - 0
^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) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) - C
^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) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) * - 1
^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) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) -
^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) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) - C
^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) * - 2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) * - 3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) - Y
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) * -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) -
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) - C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) -