Documentation/media/uapi/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 Each cell is one byte.
  34
  35
  36 .. flat-table::
  37     :header-rows:  0
  38     :stub-columns: 0
  39     :widths:       2 1 1 1 1
  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     -  .. row 6
  97
  98        -  start + 17:
  99
 100        -  Cb\ :sub:`10`
 101
 102     -  .. row 7
 103
 104        -  start + 18:
 105
 106        -  Cb\ :sub:`20`
 107
 108     -  .. row 8
 109
 110        -  start + 19:
 111
 112        -  Cb\ :sub:`30`
 113
 114     -  .. row 9
 115
 116        -  start + 20:
 117
 118        -  Cr\ :sub:`00`
 119
 120     -  .. row 10
 121
 122        -  start + 21:
 123
 124        -  Cr\ :sub:`10`
 125
 126     -  .. row 11
 127
 128        -  start + 22:
 129
 130        -  Cr\ :sub:`20`
 131
 132     -  .. row 12
 133
 134        -  start + 23:
 135
 136        -  Cr\ :sub:`30`
 137
 138
 139 **Color Sample Location..**
 140
 141
 142
 143 .. flat-table::
 144     :header-rows:  0
 145     :stub-columns: 0
 146
 147
 148     -  .. row 1
 149
 150        -
 151        -  0
 152
 153        -  1
 154
 155        -
 156        -  2
 157
 158        -  3
 159
 160     -  .. row 2
 161
 162        -  0
 163
 164        -  Y
 165
 166        -  Y
 167
 168        -  C
 169
 170        -  Y
 171
 172        -  Y
 173
 174     -  .. row 3
 175
 176        -  1
 177
 178        -  Y
 179
 180        -  Y
 181
 182        -  C
 183
 184        -  Y
 185
 186        -  Y
 187
 188     -  .. row 4
 189
 190        -  2
 191
 192        -  Y
 193
 194        -  Y
 195
 196        -  C
 197
 198        -  Y
 199
 200        -  Y
 201
 202     -  .. row 5
 203
 204        -  3
 205
 206        -  Y
 207
 208        -  Y
 209
 210        -  C
 211
 212        -  Y
 213
 214        -  Y