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

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-YUV422P:
   4
   5 *****************************
   6 V4L2_PIX_FMT_YUV422P ('422P')
   7 *****************************
   8
   9 *man V4L2_PIX_FMT_YUV422P(2)*
  10
  11 Format with ½ horizontal chroma resolution, also known as YUV 4:2:2.
  12 Planar layout as opposed to ``V4L2_PIX_FMT_YUYV``
  13
  14
  15 Description
  16 ===========
  17
  18 This format is not commonly used. This is a planar version of the YUYV
  19 format. The three components are separated into three sub-images or
  20 planes. The Y plane is first. The Y plane has one byte per pixel. The Cb
  21 plane immediately follows the Y plane in memory. The Cb plane is half
  22 the width of the Y plane (and of the image). Each Cb belongs to two
  23 pixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
  24 Y'\ :sub:`01`. Following the Cb plane is the Cr plane, just like the Cb
  25 plane.
  26
  27 If the Y plane has pad bytes after each row, then the Cr and Cb planes
  28 have half as many pad bytes after their rows. In other words, two Cx
  29 rows (including padding) is exactly as long as one Y row (including
  30 padding).
  31
  32 **Byte Order.**
  33 Each cell is one byte.
  34
  35
  36
  37 .. flat-table::
  38     :header-rows:  0
  39     :stub-columns: 0
  40     :widths:       2 1 1 1 1
  41
  42
  43     -  .. row 1
  44
  45        -  start + 0:
  46
  47        -  Y'\ :sub:`00`
  48
  49        -  Y'\ :sub:`01`
  50
  51        -  Y'\ :sub:`02`
  52
  53        -  Y'\ :sub:`03`
  54
  55     -  .. row 2
  56
  57        -  start + 4:
  58
  59        -  Y'\ :sub:`10`
  60
  61        -  Y'\ :sub:`11`
  62
  63        -  Y'\ :sub:`12`
  64
  65        -  Y'\ :sub:`13`
  66
  67     -  .. row 3
  68
  69        -  start + 8:
  70
  71        -  Y'\ :sub:`20`
  72
  73        -  Y'\ :sub:`21`
  74
  75        -  Y'\ :sub:`22`
  76
  77        -  Y'\ :sub:`23`
  78
  79     -  .. row 4
  80
  81        -  start + 12:
  82
  83        -  Y'\ :sub:`30`
  84
  85        -  Y'\ :sub:`31`
  86
  87        -  Y'\ :sub:`32`
  88
  89        -  Y'\ :sub:`33`
  90
  91     -  .. row 5
  92
  93        -  start + 16:
  94
  95        -  Cb\ :sub:`00`
  96
  97        -  Cb\ :sub:`01`
  98
  99     -  .. row 6
 100
 101        -  start + 18:
 102
 103        -  Cb\ :sub:`10`
 104
 105        -  Cb\ :sub:`11`
 106
 107     -  .. row 7
 108
 109        -  start + 20:
 110
 111        -  Cb\ :sub:`20`
 112
 113        -  Cb\ :sub:`21`
 114
 115     -  .. row 8
 116
 117        -  start + 22:
 118
 119        -  Cb\ :sub:`30`
 120
 121        -  Cb\ :sub:`31`
 122
 123     -  .. row 9
 124
 125        -  start + 24:
 126
 127        -  Cr\ :sub:`00`
 128
 129        -  Cr\ :sub:`01`
 130
 131     -  .. row 10
 132
 133        -  start + 26:
 134
 135        -  Cr\ :sub:`10`
 136
 137        -  Cr\ :sub:`11`
 138
 139     -  .. row 11
 140
 141        -  start + 28:
 142
 143        -  Cr\ :sub:`20`
 144
 145        -  Cr\ :sub:`21`
 146
 147     -  .. row 12
 148
 149        -  start + 30:
 150
 151        -  Cr\ :sub:`30`
 152
 153        -  Cr\ :sub:`31`
 154
 155
 156 **Color Sample Location..**
 157
 158
 159
 160 .. flat-table::
 161     :header-rows:  0
 162     :stub-columns: 0
 163
 164
 165     -  .. row 1
 166
 167        -
 168        -  0
 169
 170        -
 171        -  1
 172
 173        -  2
 174
 175        -
 176        -  3
 177
 178     -  .. row 2
 179
 180        -  0
 181
 182        -  Y
 183
 184        -  C
 185
 186        -  Y
 187
 188        -  Y
 189
 190        -  C
 191
 192        -  Y
 193
 194     -  .. row 3
 195
 196        -  1
 197
 198        -  Y
 199
 200        -  C
 201
 202        -  Y
 203
 204        -  Y
 205
 206        -  C
 207
 208        -  Y
 209
 210     -  .. row 4
 211
 212        -  2
 213
 214        -  Y
 215
 216        -  C
 217
 218        -  Y
 219
 220        -  Y
 221
 222        -  C
 223
 224        -  Y
 225
 226     -  .. row 5
 227
 228        -  3
 229
 230        -  Y
 231
 232        -  C
 233
 234        -  Y
 235
 236        -  Y
 237
 238        -  C
 239
 240        -  Y