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