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