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

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _V4L2-PIX-FMT-YUV444M:
   4 .. _v4l2-pix-fmt-yvu444m:
   5
   6 ************************************************************
   7 V4L2_PIX_FMT_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42')
   8 ************************************************************
   9
  10
  11 V4L2_PIX_FMT_YVU444M
  12 Planar formats with full horizontal resolution, also known as YUV and
  13 YVU 4:4:4
  14
  15
  16 Description
  17 ===========
  18
  19 This is a multi-planar format, as opposed to a packed format. The three
  20 components are separated into three sub-images or planes.
  21
  22 The Y plane is first. The Y plane has one byte per pixel. For
  23 ``V4L2_PIX_FMT_YUV444M`` the Cb data constitutes the second plane which
  24 is the same width and height as the Y plane (and as the image). The Cr
  25 data, just like the Cb plane, is in the third plane.
  26
  27 ``V4L2_PIX_FMT_YVU444M`` is the same except the Cr data is stored in the
  28 second plane and the Cb data in the third plane.
  29
  30 If the Y plane has pad bytes after each row, then the Cb and Cr planes
  31 have the same number of pad bytes after their rows.
  32
  33 ``V4L2_PIX_FMT_YUV444M`` and ``V4L2_PIX_FMT_YUV444M`` are intended to be
  34 used only in drivers and applications that support the multi-planar API,
  35 described in :ref:`planar-apis`.
  36
  37 **Byte Order.**
  38 Each cell is one byte.
  39
  40
  41 .. flat-table::
  42     :header-rows:  0
  43     :stub-columns: 0
  44
  45
  46     -  .. row 1
  47
  48        -  start0 + 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        -  start0 + 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        -  start0 + 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        -  start0 + 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        -
  97
  98     -  .. row 6
  99
 100        -  start1 + 0:
 101
 102        -  Cb\ :sub:`00`
 103
 104        -  Cb\ :sub:`01`
 105
 106        -  Cb\ :sub:`02`
 107
 108        -  Cb\ :sub:`03`
 109
 110     -  .. row 7
 111
 112        -  start1 + 4:
 113
 114        -  Cb\ :sub:`10`
 115
 116        -  Cb\ :sub:`11`
 117
 118        -  Cb\ :sub:`12`
 119
 120        -  Cb\ :sub:`13`
 121
 122     -  .. row 8
 123
 124        -  start1 + 8:
 125
 126        -  Cb\ :sub:`20`
 127
 128        -  Cb\ :sub:`21`
 129
 130        -  Cb\ :sub:`22`
 131
 132        -  Cb\ :sub:`23`
 133
 134     -  .. row 9
 135
 136        -  start1 + 12:
 137
 138        -  Cb\ :sub:`20`
 139
 140        -  Cb\ :sub:`21`
 141
 142        -  Cb\ :sub:`32`
 143
 144        -  Cb\ :sub:`33`
 145
 146     -  .. row 10
 147
 148        -
 149
 150     -  .. row 11
 151
 152        -  start2 + 0:
 153
 154        -  Cr\ :sub:`00`
 155
 156        -  Cr\ :sub:`01`
 157
 158        -  Cr\ :sub:`02`
 159
 160        -  Cr\ :sub:`03`
 161
 162     -  .. row 12
 163
 164        -  start2 + 4:
 165
 166        -  Cr\ :sub:`10`
 167
 168        -  Cr\ :sub:`11`
 169
 170        -  Cr\ :sub:`12`
 171
 172        -  Cr\ :sub:`13`
 173
 174     -  .. row 13
 175
 176        -  start2 + 8:
 177
 178        -  Cr\ :sub:`20`
 179
 180        -  Cr\ :sub:`21`
 181
 182        -  Cr\ :sub:`22`
 183
 184        -  Cr\ :sub:`23`
 185
 186     -  .. row 14
 187
 188        -  start2 + 12:
 189
 190        -  Cr\ :sub:`30`
 191
 192        -  Cr\ :sub:`31`
 193
 194        -  Cr\ :sub:`32`
 195
 196        -  Cr\ :sub:`33`
 197
 198
 199 **Color Sample Location..**
 200
 201
 202
 203 .. flat-table::
 204     :header-rows:  0
 205     :stub-columns: 0
 206
 207
 208     -  .. row 1
 209
 210        -
 211        -  0
 212
 213        -  1
 214
 215        -  2
 216
 217        -  3
 218
 219     -  .. row 2
 220
 221        -  0
 222
 223        -  YC
 224
 225        -  YC
 226
 227        -  YC
 228
 229        -  YC
 230
 231     -  .. row 3
 232
 233        -  1
 234
 235        -  YC
 236
 237        -  YC
 238
 239        -  YC
 240
 241        -  YC
 242
 243     -  .. row 4
 244
 245        -  2
 246
 247        -  YC
 248
 249        -  YC
 250
 251        -  YC
 252
 253        -  YC
 254
 255     -  .. row 5
 256
 257        -  3
 258
 259        -  YC
 260
 261        -  YC
 262
 263        -  YC
 264
 265        -  YC