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

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