Documentation/linux_tv/media/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
  34 Each cell is one byte.
  35
  36
  37
  38 .. flat-table::
  39     :header-rows:  0
  40     :stub-columns: 0
  41     :widths:       2 1 1 1 1
  42
  43
  44     -  .. row 1
  45
  46        -  start + 0:
  47
  48        -  Y'\ :sub:`00`
  49
  50        -  Y'\ :sub:`01`
  51
  52        -  Y'\ :sub:`02`
  53
  54        -  Y'\ :sub:`03`
  55
  56     -  .. row 2
  57
  58        -  start + 4:
  59
  60        -  Y'\ :sub:`10`
  61
  62        -  Y'\ :sub:`11`
  63
  64        -  Y'\ :sub:`12`
  65
  66        -  Y'\ :sub:`13`
  67
  68     -  .. row 3
  69
  70        -  start + 8:
  71
  72        -  Y'\ :sub:`20`
  73
  74        -  Y'\ :sub:`21`
  75
  76        -  Y'\ :sub:`22`
  77
  78        -  Y'\ :sub:`23`
  79
  80     -  .. row 4
  81
  82        -  start + 12:
  83
  84        -  Y'\ :sub:`30`
  85
  86        -  Y'\ :sub:`31`
  87
  88        -  Y'\ :sub:`32`
  89
  90        -  Y'\ :sub:`33`
  91
  92     -  .. row 5
  93
  94        -  start + 16:
  95
  96        -  Cb\ :sub:`00`
  97
  98        -  Cb\ :sub:`01`
  99
 100     -  .. row 6
 101
 102        -  start + 18:
 103
 104        -  Cb\ :sub:`10`
 105
 106        -  Cb\ :sub:`11`
 107
 108     -  .. row 7
 109
 110        -  start + 20:
 111
 112        -  Cb\ :sub:`20`
 113
 114        -  Cb\ :sub:`21`
 115
 116     -  .. row 8
 117
 118        -  start + 22:
 119
 120        -  Cb\ :sub:`30`
 121
 122        -  Cb\ :sub:`31`
 123
 124     -  .. row 9
 125
 126        -  start + 24:
 127
 128        -  Cr\ :sub:`00`
 129
 130        -  Cr\ :sub:`01`
 131
 132     -  .. row 10
 133
 134        -  start + 26:
 135
 136        -  Cr\ :sub:`10`
 137
 138        -  Cr\ :sub:`11`
 139
 140     -  .. row 11
 141
 142        -  start + 28:
 143
 144        -  Cr\ :sub:`20`
 145
 146        -  Cr\ :sub:`21`
 147
 148     -  .. row 12
 149
 150        -  start + 30:
 151
 152        -  Cr\ :sub:`30`
 153
 154        -  Cr\ :sub:`31`
 155
 156
 157 **Color Sample Location..**
 158
 159
 160
 161 .. flat-table::
 162     :header-rows:  0
 163     :stub-columns: 0
 164
 165
 166     -  .. row 1
 167
 168        -
 169        -  0
 170
 171        -
 172        -  1
 173
 174        -
 175        -  2
 176
 177        -
 178        -  3
 179
 180     -  .. row 2
 181
 182        -  0
 183
 184        -  Y
 185
 186        -  C
 187
 188        -  Y
 189
 190        -
 191        -  Y
 192
 193        -  C
 194
 195        -  Y
 196
 197     -  .. row 3
 198
 199        -  1
 200
 201        -  Y
 202
 203        -  C
 204
 205        -  Y
 206
 207        -
 208        -  Y
 209
 210        -  C
 211
 212        -  Y
 213
 214     -  .. row 4
 215
 216        -  2
 217
 218        -  Y
 219
 220        -  C
 221
 222        -  Y
 223
 224        -
 225        -  Y
 226
 227        -  C
 228
 229        -  Y
 230
 231     -  .. row 5
 232
 233        -  3
 234
 235        -  Y
 236
 237        -  C
 238
 239        -  Y
 240
 241        -
 242        -  Y
 243
 244        -  C
 245
 246        -  Y
 247
 248
 249
 250
 251 .. ------------------------------------------------------------------------------
 252 .. This file was automatically converted from DocBook-XML with the dbxml
 253 .. library (https://github.com/return42/sphkerneldoc). The origin XML comes
 254 .. from the linux kernel, refer to:
 255 ..
 256 .. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
 257 .. ------------------------------------------------------------------------------