Documentation/userspace-api/media/v4l/pixfmt-yuv410.rst

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   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
  11 V4L2_PIX_FMT_YUV410
  12 Planar formats with ¼ horizontal and vertical chroma resolution, also
  13 known as YUV 4:1:0
  14
  15
  16 Description
  17 ===========
  18
  19 These are planar formats, as opposed to a packed format. The three
  20 components are separated into three sub-images or planes. The Y plane is
  21 first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
  22 the Cr plane immediately follows the Y plane in memory. The Cr plane is
  23 ¼ the width and ¼ the height of the Y plane (and of the image). Each Cr
  24 belongs to 16 pixels, a four-by-four square of the image. Following the
  25 Cr plane is the Cb plane, just like the Cr plane.
  26 ``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
  27 then the Cr plane.
  28
  29 If the Y plane has pad bytes after each row, then the Cr and Cb planes
  30 have ¼ as many pad bytes after their rows. In other words, four Cx rows
  31 (including padding) are exactly as long as one Y row (including
  32 padding).
  33
  34 **Byte Order.**
  35 Each cell is one byte.
  36
  37
  38
  39
  40 .. flat-table::
  41     :header-rows:  0
  42     :stub-columns: 0
  43
  44     * - start + 0:
  45       - Y'\ :sub:`00`
  46       - Y'\ :sub:`01`
  47       - Y'\ :sub:`02`
  48       - Y'\ :sub:`03`
  49     * - start + 4:
  50       - Y'\ :sub:`10`
  51       - Y'\ :sub:`11`
  52       - Y'\ :sub:`12`
  53       - Y'\ :sub:`13`
  54     * - start + 8:
  55       - Y'\ :sub:`20`
  56       - Y'\ :sub:`21`
  57       - Y'\ :sub:`22`
  58       - Y'\ :sub:`23`
  59     * - start + 12:
  60       - Y'\ :sub:`30`
  61       - Y'\ :sub:`31`
  62       - Y'\ :sub:`32`
  63       - Y'\ :sub:`33`
  64     * - start + 16:
  65       - Cr\ :sub:`00`
  66     * - start + 17:
  67       - Cb\ :sub:`00`
  68
  69
  70 **Color Sample Location:**
  71
  72
  73
  74 .. flat-table::
  75     :header-rows:  0
  76     :stub-columns: 0
  77
  78     * -
  79       - 0
  80       -
  81       - 1
  82       -
  83       - 2
  84       -
  85       - 3
  86     * - 0
  87       - Y
  88       -
  89       - Y
  90       -
  91       - Y
  92       -
  93       - Y
  94     * -
  95     * - 1
  96       - Y
  97       -
  98       - Y
  99       -
 100       - Y
 101       -
 102       - Y
 103     * -
 104       -
 105       -
 106       -
 107       - C
 108       -
 109       -
 110       -
 111     * - 2
 112       - Y
 113       -
 114       - Y
 115       -
 116       - Y
 117       -
 118       - Y
 119     * -
 120     * - 3
 121       - Y
 122       -
 123       - Y
 124       -
 125       - Y
 126       -
 127       - Y