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

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-YUV411P:
   4
   5 *****************************
   6 V4L2_PIX_FMT_YUV411P ('411P')
   7 *****************************
   8
   9 *man V4L2_PIX_FMT_YUV411P(2)*
  10
  11 Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1.
  12 Planar layout as opposed to ``V4L2_PIX_FMT_Y41P``
  13
  14
  15 Description
  16 ===========
  17
  18 This format is not commonly used. This is a planar format similar to the
  19 4:2:2 planar format except with half as many chroma. 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. The Cb plane immediately
  22 follows the Y plane in memory. The Cb plane is ¼ the width of the Y
  23 plane (and of the image). Each Cb belongs to 4 pixels all on the same
  24 row. For example, Cb\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
  25 Y'\ :sub:`02` and Y'\ :sub:`03`. Following the Cb plane is the Cr plane,
  26 just like the Cb plane.
  27
  28 If the Y plane has pad bytes after each row, then the Cr and Cb planes
  29 have ¼ as many pad bytes after their rows. In other words, four C x rows
  30 (including padding) is exactly as long as one Y row (including 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     -  .. row 6
  99
 100        -  start + 17:
 101
 102        -  Cb\ :sub:`10`
 103
 104     -  .. row 7
 105
 106        -  start + 18:
 107
 108        -  Cb\ :sub:`20`
 109
 110     -  .. row 8
 111
 112        -  start + 19:
 113
 114        -  Cb\ :sub:`30`
 115
 116     -  .. row 9
 117
 118        -  start + 20:
 119
 120        -  Cr\ :sub:`00`
 121
 122     -  .. row 10
 123
 124        -  start + 21:
 125
 126        -  Cr\ :sub:`10`
 127
 128     -  .. row 11
 129
 130        -  start + 22:
 131
 132        -  Cr\ :sub:`20`
 133
 134     -  .. row 12
 135
 136        -  start + 23:
 137
 138        -  Cr\ :sub:`30`
 139
 140
 141 **Color Sample Location..**
 142
 143
 144
 145 .. flat-table::
 146     :header-rows:  0
 147     :stub-columns: 0
 148
 149
 150     -  .. row 1
 151
 152        -
 153        -  0
 154
 155        -
 156        -  1
 157
 158        -
 159        -  2
 160
 161        -
 162        -  3
 163
 164     -  .. row 2
 165
 166        -  0
 167
 168        -  Y
 169
 170        -
 171        -  Y
 172
 173        -  C
 174
 175        -  Y
 176
 177        -
 178        -  Y
 179
 180     -  .. row 3
 181
 182        -  1
 183
 184        -  Y
 185
 186        -
 187        -  Y
 188
 189        -  C
 190
 191        -  Y
 192
 193        -
 194        -  Y
 195
 196     -  .. row 4
 197
 198        -  2
 199
 200        -  Y
 201
 202        -
 203        -  Y
 204
 205        -  C
 206
 207        -  Y
 208
 209        -
 210        -  Y
 211
 212     -  .. row 5
 213
 214        -  3
 215
 216        -  Y
 217
 218        -
 219        -  Y
 220
 221        -  C
 222
 223        -  Y
 224
 225        -
 226        -  Y
 227
 228
 229
 230
 231 .. ------------------------------------------------------------------------------
 232 .. This file was automatically converted from DocBook-XML with the dbxml
 233 .. library (https://github.com/return42/sphkerneldoc). The origin XML comes
 234 .. from the linux kernel, refer to:
 235 ..
 236 .. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
 237 .. ------------------------------------------------------------------------------