Documentation/linux_tv/media/v4l/pixfmt-yuv422m.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-YUV422M:
   4
   5 ************************************************************
   6 V4L2_PIX_FMT_YUV422M ('YM16'), V4L2_PIX_FMT_YVU422M ('YM61')
   7 ************************************************************
   8
   9 *man V4L2_PIX_FMT_YUV422M(2)*
  10
  11 V4L2_PIX_FMT_YVU422M
  12 Planar formats with ½ horizontal resolution, also known as YUV and YVU
  13 4:2:2
  14
  15
  16 Description
  17 ===========
  18
  19 This is a multi-planar format, as opposed to a packed format. The three
  20 components are separated into three sub-images or planes.
  21
  22 The Y plane is first. The Y plane has one byte per pixel. For
  23 ``V4L2_PIX_FMT_YUV422M`` the Cb data constitutes the second plane which
  24 is half the width of the Y plane (and of the image). Each Cb belongs to
  25 two pixels. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`,
  26 Y'\ :sub:`01`. The Cr data, just like the Cb plane, is in the third
  27 plane.
  28
  29 ``V4L2_PIX_FMT_YVU422M`` is the same except the Cr data is stored in the
  30 second plane and the Cb data in the third plane.
  31
  32 If the Y plane has pad bytes after each row, then the Cb and Cr planes
  33 have half as many pad bytes after their rows. In other words, two Cx
  34 rows (including padding) is exactly as long as one Y row (including
  35 padding).
  36
  37 ``V4L2_PIX_FMT_YUV422M`` and ``V4L2_PIX_FMT_YVU422M`` are intended to be
  38 used only in drivers and applications that support the multi-planar API,
  39 described in :ref:`planar-apis`.
  40
  41 **Byte Order..**
  42
  43 Each cell is one byte.
  44
  45
  46
  47 .. flat-table::
  48     :header-rows:  0
  49     :stub-columns: 0
  50     :widths:       2 1 1 1 1
  51
  52
  53     -  .. row 1
  54
  55        -  start0 + 0:
  56
  57        -  Y'\ :sub:`00`
  58
  59        -  Y'\ :sub:`01`
  60
  61        -  Y'\ :sub:`02`
  62
  63        -  Y'\ :sub:`03`
  64
  65     -  .. row 2
  66
  67        -  start0 + 4:
  68
  69        -  Y'\ :sub:`10`
  70
  71        -  Y'\ :sub:`11`
  72
  73        -  Y'\ :sub:`12`
  74
  75        -  Y'\ :sub:`13`
  76
  77     -  .. row 3
  78
  79        -  start0 + 8:
  80
  81        -  Y'\ :sub:`20`
  82
  83        -  Y'\ :sub:`21`
  84
  85        -  Y'\ :sub:`22`
  86
  87        -  Y'\ :sub:`23`
  88
  89     -  .. row 4
  90
  91        -  start0 + 12:
  92
  93        -  Y'\ :sub:`30`
  94
  95        -  Y'\ :sub:`31`
  96
  97        -  Y'\ :sub:`32`
  98
  99        -  Y'\ :sub:`33`
 100
 101     -  .. row 5
 102
 103        -
 104
 105     -  .. row 6
 106
 107        -  start1 + 0:
 108
 109        -  Cb\ :sub:`00`
 110
 111        -  Cb\ :sub:`01`
 112
 113     -  .. row 7
 114
 115        -  start1 + 2:
 116
 117        -  Cb\ :sub:`10`
 118
 119        -  Cb\ :sub:`11`
 120
 121     -  .. row 8
 122
 123        -  start1 + 4:
 124
 125        -  Cb\ :sub:`20`
 126
 127        -  Cb\ :sub:`21`
 128
 129     -  .. row 9
 130
 131        -  start1 + 6:
 132
 133        -  Cb\ :sub:`30`
 134
 135        -  Cb\ :sub:`31`
 136
 137     -  .. row 10
 138
 139        -
 140
 141     -  .. row 11
 142
 143        -  start2 + 0:
 144
 145        -  Cr\ :sub:`00`
 146
 147        -  Cr\ :sub:`01`
 148
 149     -  .. row 12
 150
 151        -  start2 + 2:
 152
 153        -  Cr\ :sub:`10`
 154
 155        -  Cr\ :sub:`11`
 156
 157     -  .. row 13
 158
 159        -  start2 + 4:
 160
 161        -  Cr\ :sub:`20`
 162
 163        -  Cr\ :sub:`21`
 164
 165     -  .. row 14
 166
 167        -  start2 + 6:
 168
 169        -  Cr\ :sub:`30`
 170
 171        -  Cr\ :sub:`31`
 172
 173
 174 **Color Sample Location..**
 175
 176
 177
 178 .. flat-table::
 179     :header-rows:  0
 180     :stub-columns: 0
 181
 182
 183     -  .. row 1
 184
 185        -
 186        -  0
 187
 188        -
 189        -  1
 190
 191        -
 192        -  2
 193
 194        -
 195        -  3
 196
 197     -  .. row 2
 198
 199        -  0
 200
 201        -  Y
 202
 203        -  C
 204
 205        -  Y
 206
 207        -
 208        -  Y
 209
 210        -  C
 211
 212        -  Y
 213
 214     -  .. row 3
 215
 216        -  1
 217
 218        -  Y
 219
 220        -  C
 221
 222        -  Y
 223
 224        -
 225        -  Y
 226
 227        -  C
 228
 229        -  Y
 230
 231     -  .. row 4
 232
 233        -  2
 234
 235        -  Y
 236
 237        -  C
 238
 239        -  Y
 240
 241        -
 242        -  Y
 243
 244        -  C
 245
 246        -  Y
 247
 248     -  .. row 5
 249
 250        -  3
 251
 252        -  Y
 253
 254        -  C
 255
 256        -  Y
 257
 258        -
 259        -  Y
 260
 261        -  C
 262
 263        -  Y
 264
 265
 266
 267
 268 .. ------------------------------------------------------------------------------
 269 .. This file was automatically converted from DocBook-XML with the dbxml
 270 .. library (https://github.com/return42/sphkerneldoc). The origin XML comes
 271 .. from the linux kernel, refer to:
 272 ..
 273 .. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
 274 .. ------------------------------------------------------------------------------