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

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-NV24:
   4 .. _V4L2-PIX-FMT-NV42:
   5
   6 ******************************************************
   7 V4L2_PIX_FMT_NV24 ('NV24'), V4L2_PIX_FMT_NV42 ('NV42')
   8 ******************************************************
   9
  10 *man V4L2_PIX_FMT_NV24(2)*
  11
  12 V4L2_PIX_FMT_NV42
  13 Formats with full horizontal and vertical chroma resolutions, also known
  14 as YUV 4:4:4. One luminance and one chrominance plane with alternating
  15 chroma samples as opposed to ``V4L2_PIX_FMT_YVU420``
  16
  17
  18 Description
  19 ===========
  20
  21 These are two-plane versions of the YUV 4:4:4 format. The three
  22 components are separated into two sub-images or planes. The Y plane is
  23 first, with each Y sample stored in one byte per pixel. For
  24 ``V4L2_PIX_FMT_NV24``, a combined CbCr plane immediately follows the Y
  25 plane in memory. The CbCr plane has the same width and height, in
  26 pixels, as the Y plane (and the image). Each line contains one CbCr pair
  27 per pixel, with each Cb and Cr sample stored in one byte.
  28 ``V4L2_PIX_FMT_NV42`` is the same except that the Cb and Cr samples are
  29 swapped, the CrCb plane starts with a Cr sample.
  30
  31 If the Y plane has pad bytes after each row, then the CbCr plane has
  32 twice as many pad bytes after its rows.
  33
  34 **Byte Order.**
  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 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        -  Cb\ :sub:`02`
 106
 107        -  Cr\ :sub:`02`
 108
 109        -  Cb\ :sub:`03`
 110
 111        -  Cr\ :sub:`03`
 112
 113     -  .. row 6
 114
 115        -  start + 24:
 116
 117        -  Cb\ :sub:`10`
 118
 119        -  Cr\ :sub:`10`
 120
 121        -  Cb\ :sub:`11`
 122
 123        -  Cr\ :sub:`11`
 124
 125        -  Cb\ :sub:`12`
 126
 127        -  Cr\ :sub:`12`
 128
 129        -  Cb\ :sub:`13`
 130
 131        -  Cr\ :sub:`13`
 132
 133     -  .. row 7
 134
 135        -  start + 32:
 136
 137        -  Cb\ :sub:`20`
 138
 139        -  Cr\ :sub:`20`
 140
 141        -  Cb\ :sub:`21`
 142
 143        -  Cr\ :sub:`21`
 144
 145        -  Cb\ :sub:`22`
 146
 147        -  Cr\ :sub:`22`
 148
 149        -  Cb\ :sub:`23`
 150
 151        -  Cr\ :sub:`23`
 152
 153     -  .. row 8
 154
 155        -  start + 40:
 156
 157        -  Cb\ :sub:`30`
 158
 159        -  Cr\ :sub:`30`
 160
 161        -  Cb\ :sub:`31`
 162
 163        -  Cr\ :sub:`31`
 164
 165        -  Cb\ :sub:`32`
 166
 167        -  Cr\ :sub:`32`
 168
 169        -  Cb\ :sub:`33`
 170
 171        -  Cr\ :sub:`33`