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

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