Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _packed-yuv:
   4
   5 ******************
   6 Packed YUV formats
   7 ******************
   8
   9 Description
  10 ===========
  11
  12 Similar to the packed RGB formats these formats store the Y, Cb and Cr
  13 component of each pixel in one 16 or 32 bit word.
  14
  15 .. raw:: latex
  16
  17     \newline\newline\begin{adjustbox}{width=\columnwidth}
  18
  19 .. _packed-yuv-formats:
  20
  21 .. tabularcolumns:: |p{4.5cm}|p{3.3cm}|p{0.7cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{1.7cm}|
  22
  23 .. flat-table:: Packed YUV Image Formats
  24     :header-rows:  2
  25     :stub-columns: 0
  26
  27
  28     -  .. row 1
  29
  30        -  Identifier
  31
  32        -  Code
  33
  34        -
  35        -  :cspan:`7` Byte 0 in memory
  36
  37        -
  38        -  :cspan:`7` Byte 1
  39
  40        -
  41        -  :cspan:`7` Byte 2
  42
  43        -
  44        -  :cspan:`7` Byte 3
  45
  46     -  .. row 2
  47
  48        -
  49        -
  50        -  Bit
  51
  52        -  7
  53
  54        -  6
  55
  56        -  5
  57
  58        -  4
  59
  60        -  3
  61
  62        -  2
  63
  64        -  1
  65
  66        -  0
  67
  68        -
  69        -  7
  70
  71        -  6
  72
  73        -  5
  74
  75        -  4
  76
  77        -  3
  78
  79        -  2
  80
  81        -  1
  82
  83        -  0
  84
  85        -
  86        -  7
  87
  88        -  6
  89
  90        -  5
  91
  92        -  4
  93
  94        -  3
  95
  96        -  2
  97
  98        -  1
  99
 100        -  0
 101
 102        -
 103        -  7
 104
 105        -  6
 106
 107        -  5
 108
 109        -  4
 110
 111        -  3
 112
 113        -  2
 114
 115        -  1
 116
 117        -  0
 118
 119     -  .. _V4L2-PIX-FMT-YUV444:
 120
 121        -  ``V4L2_PIX_FMT_YUV444``
 122
 123        -  'Y444'
 124
 125        -
 126        -  Cb\ :sub:`3`
 127
 128        -  Cb\ :sub:`2`
 129
 130        -  Cb\ :sub:`1`
 131
 132        -  Cb\ :sub:`0`
 133
 134        -  Cr\ :sub:`3`
 135
 136        -  Cr\ :sub:`2`
 137
 138        -  Cr\ :sub:`1`
 139
 140        -  Cr\ :sub:`0`
 141
 142        -
 143        -  a\ :sub:`3`
 144
 145        -  a\ :sub:`2`
 146
 147        -  a\ :sub:`1`
 148
 149        -  a\ :sub:`0`
 150
 151        -  Y'\ :sub:`3`
 152
 153        -  Y'\ :sub:`2`
 154
 155        -  Y'\ :sub:`1`
 156
 157        -  Y'\ :sub:`0`
 158
 159     -  .. _V4L2-PIX-FMT-YUV555:
 160
 161        -  ``V4L2_PIX_FMT_YUV555``
 162
 163        -  'YUVO'
 164
 165        -
 166        -  Cb\ :sub:`2`
 167
 168        -  Cb\ :sub:`1`
 169
 170        -  Cb\ :sub:`0`
 171
 172        -  Cr\ :sub:`4`
 173
 174        -  Cr\ :sub:`3`
 175
 176        -  Cr\ :sub:`2`
 177
 178        -  Cr\ :sub:`1`
 179
 180        -  Cr\ :sub:`0`
 181
 182        -
 183        -  a
 184
 185        -  Y'\ :sub:`4`
 186
 187        -  Y'\ :sub:`3`
 188
 189        -  Y'\ :sub:`2`
 190
 191        -  Y'\ :sub:`1`
 192
 193        -  Y'\ :sub:`0`
 194
 195        -  Cb\ :sub:`4`
 196
 197        -  Cb\ :sub:`3`
 198
 199     -  .. _V4L2-PIX-FMT-YUV565:
 200
 201        -  ``V4L2_PIX_FMT_YUV565``
 202
 203        -  'YUVP'
 204
 205        -
 206        -  Cb\ :sub:`2`
 207
 208        -  Cb\ :sub:`1`
 209
 210        -  Cb\ :sub:`0`
 211
 212        -  Cr\ :sub:`4`
 213
 214        -  Cr\ :sub:`3`
 215
 216        -  Cr\ :sub:`2`
 217
 218        -  Cr\ :sub:`1`
 219
 220        -  Cr\ :sub:`0`
 221
 222        -
 223        -  Y'\ :sub:`4`
 224
 225        -  Y'\ :sub:`3`
 226
 227        -  Y'\ :sub:`2`
 228
 229        -  Y'\ :sub:`1`
 230
 231        -  Y'\ :sub:`0`
 232
 233        -  Cb\ :sub:`5`
 234
 235        -  Cb\ :sub:`4`
 236
 237        -  Cb\ :sub:`3`
 238
 239     -  .. _V4L2-PIX-FMT-YUV32:
 240
 241        -  ``V4L2_PIX_FMT_YUV32``
 242
 243        -  'YUV4'
 244
 245        -
 246        -  a\ :sub:`7`
 247
 248        -  a\ :sub:`6`
 249
 250        -  a\ :sub:`5`
 251
 252        -  a\ :sub:`4`
 253
 254        -  a\ :sub:`3`
 255
 256        -  a\ :sub:`2`
 257
 258        -  a\ :sub:`1`
 259
 260        -  a\ :sub:`0`
 261
 262        -
 263        -  Y'\ :sub:`7`
 264
 265        -  Y'\ :sub:`6`
 266
 267        -  Y'\ :sub:`5`
 268
 269        -  Y'\ :sub:`4`
 270
 271        -  Y'\ :sub:`3`
 272
 273        -  Y'\ :sub:`2`
 274
 275        -  Y'\ :sub:`1`
 276
 277        -  Y'\ :sub:`0`
 278
 279        -
 280        -  Cb\ :sub:`7`
 281
 282        -  Cb\ :sub:`6`
 283
 284        -  Cb\ :sub:`5`
 285
 286        -  Cb\ :sub:`4`
 287
 288        -  Cb\ :sub:`3`
 289
 290        -  Cb\ :sub:`2`
 291
 292        -  Cb\ :sub:`1`
 293
 294        -  Cb\ :sub:`0`
 295
 296        -
 297        -  Cr\ :sub:`7`
 298
 299        -  Cr\ :sub:`6`
 300
 301        -  Cr\ :sub:`5`
 302
 303        -  Cr\ :sub:`4`
 304
 305        -  Cr\ :sub:`3`
 306
 307        -  Cr\ :sub:`2`
 308
 309        -  Cr\ :sub:`1`
 310
 311        -  Cr\ :sub:`0`
 312
 313 .. raw:: latex
 314
 315     \end{adjustbox}\newline\newline
 316
 317 .. note::
 318
 319     #) Bit 7 is the most significant bit;
 320
 321     #) The value of a = alpha bits is undefined when reading from the driver,
 322        ignored when writing to the driver, except when alpha blending has
 323        been negotiated for a :ref:`Video Overlay <overlay>` or
 324        :ref:`Video Output Overlay <osd>`.