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

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