1.. Permission is granted to copy, distribute and/or modify this 2.. document under the terms of the GNU Free Documentation License, 3.. Version 1.1 or any later version published by the Free Software 4.. Foundation, with no Invariant Sections, no Front-Cover Texts 5.. and no Back-Cover Texts. A copy of the license is included at 6.. Documentation/media/uapi/fdl-appendix.rst. 7.. 8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections 9 10.. _V4L2-PIX-FMT-NV16: 11.. _V4L2-PIX-FMT-NV61: 12 13****************************************************** 14V4L2_PIX_FMT_NV16 ('NV16'), V4L2_PIX_FMT_NV61 ('NV61') 15****************************************************** 16 17V4L2_PIX_FMT_NV61 18Formats with ½ horizontal chroma resolution, also known as YUV 4:2:2. 19One luminance and one chrominance plane with alternating chroma samples 20as opposed to ``V4L2_PIX_FMT_YVU420`` 21 22 23Description 24=========== 25 26These are two-plane versions of the YUV 4:2:2 format. The three 27components are separated into two sub-images or planes. The Y plane is 28first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV16``, a 29combined CbCr plane immediately follows the Y plane in memory. The CbCr 30plane is the same width and height, in bytes, as the Y plane (and of the 31image). Each CbCr pair belongs to two pixels. For example, 32Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`. 33``V4L2_PIX_FMT_NV61`` is the same except the Cb and Cr bytes are 34swapped, the CrCb plane starts with a Cr byte. 35 36If the Y plane has pad bytes after each row, then the CbCr plane has as 37many pad bytes after its rows. 38 39**Byte Order.** 40Each cell is one byte. 41 42 43.. flat-table:: 44 :header-rows: 0 45 :stub-columns: 0 46 47 * - start + 0: 48 - Y'\ :sub:`00` 49 - Y'\ :sub:`01` 50 - Y'\ :sub:`02` 51 - Y'\ :sub:`03` 52 * - start + 4: 53 - Y'\ :sub:`10` 54 - Y'\ :sub:`11` 55 - Y'\ :sub:`12` 56 - Y'\ :sub:`13` 57 * - start + 8: 58 - Y'\ :sub:`20` 59 - Y'\ :sub:`21` 60 - Y'\ :sub:`22` 61 - Y'\ :sub:`23` 62 * - start + 12: 63 - Y'\ :sub:`30` 64 - Y'\ :sub:`31` 65 - Y'\ :sub:`32` 66 - Y'\ :sub:`33` 67 * - start + 16: 68 - Cb\ :sub:`00` 69 - Cr\ :sub:`00` 70 - Cb\ :sub:`01` 71 - Cr\ :sub:`01` 72 * - start + 20: 73 - Cb\ :sub:`10` 74 - Cr\ :sub:`10` 75 - Cb\ :sub:`11` 76 - Cr\ :sub:`11` 77 * - start + 24: 78 - Cb\ :sub:`20` 79 - Cr\ :sub:`20` 80 - Cb\ :sub:`21` 81 - Cr\ :sub:`21` 82 * - start + 28: 83 - Cb\ :sub:`30` 84 - Cr\ :sub:`30` 85 - Cb\ :sub:`31` 86 - Cr\ :sub:`31` 87 88 89**Color Sample Location:** 90 91 92 93.. flat-table:: 94 :header-rows: 0 95 :stub-columns: 0 96 97 * - 98 - 0 99 - 100 - 1 101 - 2 102 - 103 - 3 104 * - 0 105 - Y 106 - 107 - Y 108 - Y 109 - 110 - Y 111 * - 112 - 113 - C 114 - 115 - 116 - C 117 - 118 * - 1 119 - Y 120 - 121 - Y 122 - Y 123 - 124 - Y 125 * - 126 - 127 - C 128 - 129 - 130 - C 131 - 132 * - 133 * - 2 134 - Y 135 - 136 - Y 137 - Y 138 - 139 - Y 140 * - 141 - 142 - C 143 - 144 - 145 - C 146 - 147 * - 3 148 - Y 149 - 150 - Y 151 - Y 152 - 153 - Y 154 * - 155 - 156 - C 157 - 158 - 159 - C 160 - 161