Documentation/media/uapi/v4l/pixfmt-nv16.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-NV16:
   4 .. _V4L2-PIX-FMT-NV61:
   5
   6 ******************************************************
   7 V4L2_PIX_FMT_NV16 ('NV16'), V4L2_PIX_FMT_NV61 ('NV61')
   8 ******************************************************
   9
  10 *man V4L2_PIX_FMT_NV16(2)*
  11
  12 V4L2_PIX_FMT_NV61
  13 Formats with ½ horizontal chroma resolution, also known as YUV 4:2:2.
  14 One luminance and one chrominance plane with alternating chroma samples
  15 as opposed to ``V4L2_PIX_FMT_YVU420``
  16
  17
  18 Description
  19 ===========
  20
  21 These are two-plane versions of the YUV 4:2:2 format. The three
  22 components are separated into two sub-images or planes. The Y plane is
  23 first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_NV16``, a
  24 combined CbCr plane immediately follows the Y plane in memory. The CbCr
  25 plane is the same width and height, in bytes, as the Y plane (and of the
  26 image). Each CbCr pair belongs to two pixels. For example,
  27 Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`.
  28 ``V4L2_PIX_FMT_NV61`` is the same except the Cb and Cr bytes are
  29 swapped, the CrCb plane starts with a Cr byte.
  30
  31 If the Y plane has pad bytes after each row, then the CbCr plane has as
  32 many pad bytes after its rows.
  33
  34 **Byte Order.**
  35 Each cell is one byte.
  36
  37
  38
  39 .. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}|
  40
  41 .. flat-table::
  42     :header-rows:  0
  43     :stub-columns: 0
  44     :widths:       2 1 1 1 1
  45
  46
  47     -  .. row 1
  48
  49        -  start + 0:
  50
  51        -  Y'\ :sub:`00`
  52
  53        -  Y'\ :sub:`01`
  54
  55        -  Y'\ :sub:`02`
  56
  57        -  Y'\ :sub:`03`
  58
  59     -  .. row 2
  60
  61        -  start + 4:
  62
  63        -  Y'\ :sub:`10`
  64
  65        -  Y'\ :sub:`11`
  66
  67        -  Y'\ :sub:`12`
  68
  69        -  Y'\ :sub:`13`
  70
  71     -  .. row 3
  72
  73        -  start + 8:
  74
  75        -  Y'\ :sub:`20`
  76
  77        -  Y'\ :sub:`21`
  78
  79        -  Y'\ :sub:`22`
  80
  81        -  Y'\ :sub:`23`
  82
  83     -  .. row 4
  84
  85        -  start + 12:
  86
  87        -  Y'\ :sub:`30`
  88
  89        -  Y'\ :sub:`31`
  90
  91        -  Y'\ :sub:`32`
  92
  93        -  Y'\ :sub:`33`
  94
  95     -  .. row 5
  96
  97        -  start + 16:
  98
  99        -  Cb\ :sub:`00`
 100
 101        -  Cr\ :sub:`00`
 102
 103        -  Cb\ :sub:`01`
 104
 105        -  Cr\ :sub:`01`
 106
 107     -  .. row 6
 108
 109        -  start + 20:
 110
 111        -  Cb\ :sub:`10`
 112
 113        -  Cr\ :sub:`10`
 114
 115        -  Cb\ :sub:`11`
 116
 117        -  Cr\ :sub:`11`
 118
 119     -  .. row 7
 120
 121        -  start + 24:
 122
 123        -  Cb\ :sub:`20`
 124
 125        -  Cr\ :sub:`20`
 126
 127        -  Cb\ :sub:`21`
 128
 129        -  Cr\ :sub:`21`
 130
 131     -  .. row 8
 132
 133        -  start + 28:
 134
 135        -  Cb\ :sub:`30`
 136
 137        -  Cr\ :sub:`30`
 138
 139        -  Cb\ :sub:`31`
 140
 141        -  Cr\ :sub:`31`
 142
 143
 144 **Color Sample Location..**
 145
 146
 147
 148 .. flat-table::
 149     :header-rows:  0
 150     :stub-columns: 0
 151
 152
 153     -  .. row 1
 154
 155        -
 156        -  0
 157
 158        -
 159        -  1
 160
 161        -  2
 162
 163        -
 164        -  3
 165
 166     -  .. row 2
 167
 168        -  0
 169
 170        -  Y
 171
 172        -
 173        -  Y
 174
 175        -  Y
 176
 177        -
 178        -  Y
 179
 180     -  .. row 3
 181
 182        -
 183        -
 184        -  C
 185
 186        -
 187        -
 188        -  C
 189
 190        -
 191
 192     -  .. row 4
 193
 194        -  1
 195
 196        -  Y
 197
 198        -
 199        -  Y
 200
 201        -  Y
 202
 203        -
 204        -  Y
 205
 206     -  .. row 5
 207
 208        -
 209        -
 210        -  C
 211
 212        -
 213        -
 214        -  C
 215
 216        -
 217
 218     -  .. row 6
 219
 220        -
 221
 222     -  .. row 7
 223
 224        -  2
 225
 226        -  Y
 227
 228        -
 229        -  Y
 230
 231        -  Y
 232
 233        -
 234        -  Y
 235
 236     -  .. row 8
 237
 238        -
 239        -
 240        -  C
 241
 242        -
 243        -
 244        -  C
 245
 246        -
 247
 248     -  .. row 9
 249
 250        -  3
 251
 252        -  Y
 253
 254        -
 255        -  Y
 256
 257        -  Y
 258
 259        -
 260        -  Y
 261
 262     -  .. row 10
 263
 264        -
 265        -
 266        -  C
 267
 268        -
 269        -
 270        -  C
 271
 272        -