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

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-YVU410:
   4 .. _v4l2-pix-fmt-yuv410:
   5
   6 **********************************************************
   7 V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9')
   8 **********************************************************
   9
  10
  11 V4L2_PIX_FMT_YUV410
  12 Planar formats with ¼ horizontal and vertical chroma resolution, also
  13 known as YUV 4:1:0
  14
  15
  16 Description
  17 ===========
  18
  19 These are planar formats, as opposed to a packed format. The three
  20 components are separated into three sub-images or planes. The Y plane is
  21 first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
  22 the Cr plane immediately follows the Y plane in memory. The Cr plane is
  23 ¼ the width and ¼ the height of the Y plane (and of the image). Each Cr
  24 belongs to 16 pixels, a four-by-four square of the image. Following the
  25 Cr plane is the Cb plane, just like the Cr plane.
  26 ``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
  27 then the Cr plane.
  28
  29 If the Y plane has pad bytes after each row, then the Cr and Cb planes
  30 have ¼ as many pad bytes after their rows. In other words, four Cx rows
  31 (including padding) are exactly as long as one Y row (including
  32 padding).
  33
  34 **Byte Order.**
  35 Each cell is one byte.
  36
  37
  38
  39
  40 .. flat-table::
  41     :header-rows:  0
  42     :stub-columns: 0
  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        -  Cr\ :sub:`00`
  98
  99     -  .. row 6
 100
 101        -  start + 17:
 102
 103        -  Cb\ :sub:`00`
 104
 105
 106 **Color Sample Location..**
 107
 108
 109
 110 .. flat-table::
 111     :header-rows:  0
 112     :stub-columns: 0
 113
 114
 115     -  .. row 1
 116
 117        -
 118        -  0
 119
 120        -
 121        -  1
 122
 123        -
 124        -  2
 125
 126        -
 127        -  3
 128
 129     -  .. row 2
 130
 131        -  0
 132
 133        -  Y
 134
 135        -
 136        -  Y
 137
 138        -
 139        -  Y
 140
 141        -
 142        -  Y
 143
 144     -  .. row 3
 145
 146        -
 147
 148     -  .. row 4
 149
 150        -  1
 151
 152        -  Y
 153
 154        -
 155        -  Y
 156
 157        -
 158        -  Y
 159
 160        -
 161        -  Y
 162
 163     -  .. row 5
 164
 165        -
 166        -
 167        -
 168        -
 169        -  C
 170
 171        -
 172        -
 173        -
 174
 175     -  .. row 6
 176
 177        -  2
 178
 179        -  Y
 180
 181        -
 182        -  Y
 183
 184        -
 185        -  Y
 186
 187        -
 188        -  Y
 189
 190     -  .. row 7
 191
 192        -
 193
 194     -  .. row 8
 195
 196        -  3
 197
 198        -  Y
 199
 200        -
 201        -  Y
 202
 203        -
 204        -  Y
 205
 206        -
 207        -  Y