Documentation/media/uapi/v4l/pixfmt-m420.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-M420:
   4
   5 **************************
   6 V4L2_PIX_FMT_M420 ('M420')
   7 **************************
   8
   9 *man V4L2_PIX_FMT_M420(2)*
  10
  11 Format with ½ horizontal and vertical chroma resolution, also known as
  12 YUV 4:2:0. Hybrid plane line-interleaved layout.
  13
  14
  15 Description
  16 ===========
  17
  18 M420 is a YUV format with ½ horizontal and vertical chroma subsampling
  19 (YUV 4:2:0). Pixels are organized as interleaved luma and chroma planes.
  20 Two lines of luma data are followed by one line of chroma data.
  21
  22 The luma plane has one byte per pixel. The chroma plane contains
  23 interleaved CbCr pixels subsampled by ½ in the horizontal and vertical
  24 directions. Each CbCr pair belongs to four pixels. For example,
  25 Cb\ :sub:`0`/Cr\ :sub:`0` belongs to Y'\ :sub:`00`, Y'\ :sub:`01`,
  26 Y'\ :sub:`10`, Y'\ :sub:`11`.
  27
  28 All line lengths are identical: if the Y lines include pad bytes so do
  29 the CbCr lines.
  30
  31 **Byte Order.**
  32 Each cell is one byte.
  33
  34
  35
  36 .. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}|
  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        -  Cb\ :sub:`00`
  73
  74        -  Cr\ :sub:`00`
  75
  76        -  Cb\ :sub:`01`
  77
  78        -  Cr\ :sub:`01`
  79
  80     -  .. row 4
  81
  82        -  start + 16:
  83
  84        -  Y'\ :sub:`20`
  85
  86        -  Y'\ :sub:`21`
  87
  88        -  Y'\ :sub:`22`
  89
  90        -  Y'\ :sub:`23`
  91
  92     -  .. row 5
  93
  94        -  start + 20:
  95
  96        -  Y'\ :sub:`30`
  97
  98        -  Y'\ :sub:`31`
  99
 100        -  Y'\ :sub:`32`
 101
 102        -  Y'\ :sub:`33`
 103
 104     -  .. row 6
 105
 106        -  start + 24:
 107
 108        -  Cb\ :sub:`10`
 109
 110        -  Cr\ :sub:`10`
 111
 112        -  Cb\ :sub:`11`
 113
 114        -  Cr\ :sub:`11`
 115
 116
 117 **Color Sample Location..**
 118
 119
 120
 121 .. flat-table::
 122     :header-rows:  0
 123     :stub-columns: 0
 124
 125
 126     -  .. row 1
 127
 128        -
 129        -  0
 130
 131        -
 132        -  1
 133
 134        -  2
 135
 136        -
 137        -  3
 138
 139     -  .. row 2
 140
 141        -  0
 142
 143        -  Y
 144
 145        -
 146        -  Y
 147
 148        -  Y
 149
 150        -
 151        -  Y
 152
 153     -  .. row 3
 154
 155        -
 156        -
 157        -  C
 158
 159        -
 160        -
 161        -  C
 162
 163        -
 164
 165     -  .. row 4
 166
 167        -  1
 168
 169        -  Y
 170
 171        -
 172        -  Y
 173
 174        -  Y
 175
 176        -
 177        -  Y
 178
 179     -  .. row 5
 180
 181        -
 182
 183     -  .. row 6
 184
 185        -  2
 186
 187        -  Y
 188
 189        -
 190        -  Y
 191
 192        -  Y
 193
 194        -
 195        -  Y
 196
 197     -  .. row 7
 198
 199        -
 200        -
 201        -  C
 202
 203        -
 204        -
 205        -  C
 206
 207        -
 208
 209     -  .. row 8
 210
 211        -  3
 212
 213        -  Y
 214
 215        -
 216        -  Y
 217
 218        -  Y
 219
 220        -
 221        -  Y