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

   1 .. Permission is granted to copy, distribute and/or modify this
   2 .. document under the terms of the GNU Free Documentation License,
   3 .. Version 1.1 or any later version published by the Free Software
   4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
   5 .. and no Back-Cover Texts. A copy of the license is included at
   6 .. Documentation/media/uapi/fdl-appendix.rst.
   7 ..
   8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
   9
  10 .. _V4L2-PIX-FMT-YVU410:
  11 .. _v4l2-pix-fmt-yuv410:
  12
  13 **********************************************************
  14 V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9')
  15 **********************************************************
  16
  17
  18 V4L2_PIX_FMT_YUV410
  19 Planar formats with ¼ horizontal and vertical chroma resolution, also
  20 known as YUV 4:1:0
  21
  22
  23 Description
  24 ===========
  25
  26 These are planar formats, as opposed to a packed format. The three
  27 components are separated into three sub-images or planes. The Y plane is
  28 first. The Y plane has one byte per pixel. For ``V4L2_PIX_FMT_YVU410``,
  29 the Cr plane immediately follows the Y plane in memory. The Cr plane is
  30 ¼ the width and ¼ the height of the Y plane (and of the image). Each Cr
  31 belongs to 16 pixels, a four-by-four square of the image. Following the
  32 Cr plane is the Cb plane, just like the Cr plane.
  33 ``V4L2_PIX_FMT_YUV410`` is the same, except the Cb plane comes first,
  34 then the Cr plane.
  35
  36 If the Y plane has pad bytes after each row, then the Cr and Cb planes
  37 have ¼ as many pad bytes after their rows. In other words, four Cx rows
  38 (including padding) are exactly as long as one Y row (including
  39 padding).
  40
  41 **Byte Order.**
  42 Each cell is one byte.
  43
  44
  45
  46
  47 .. flat-table::
  48     :header-rows:  0
  49     :stub-columns: 0
  50
  51     * - start + 0:
  52       - Y'\ :sub:`00`
  53       - Y'\ :sub:`01`
  54       - Y'\ :sub:`02`
  55       - Y'\ :sub:`03`
  56     * - start + 4:
  57       - Y'\ :sub:`10`
  58       - Y'\ :sub:`11`
  59       - Y'\ :sub:`12`
  60       - Y'\ :sub:`13`
  61     * - start + 8:
  62       - Y'\ :sub:`20`
  63       - Y'\ :sub:`21`
  64       - Y'\ :sub:`22`
  65       - Y'\ :sub:`23`
  66     * - start + 12:
  67       - Y'\ :sub:`30`
  68       - Y'\ :sub:`31`
  69       - Y'\ :sub:`32`
  70       - Y'\ :sub:`33`
  71     * - start + 16:
  72       - Cr\ :sub:`00`
  73     * - start + 17:
  74       - Cb\ :sub:`00`
  75
  76
  77 **Color Sample Location:**
  78
  79
  80
  81 .. flat-table::
  82     :header-rows:  0
  83     :stub-columns: 0
  84
  85     * -
  86       - 0
  87       -
  88       - 1
  89       -
  90       - 2
  91       -
  92       - 3
  93     * - 0
  94       - Y
  95       -
  96       - Y
  97       -
  98       - Y
  99       -
 100       - Y
 101     * -
 102     * - 1
 103       - Y
 104       -
 105       - Y
 106       -
 107       - Y
 108       -
 109       - Y
 110     * -
 111       -
 112       -
 113       -
 114       - C
 115       -
 116       -
 117       -
 118     * - 2
 119       - Y
 120       -
 121       - Y
 122       -
 123       - Y
 124       -
 125       - Y
 126     * -
 127     * - 3
 128       - Y
 129       -
 130       - Y
 131       -
 132       - Y
 133       -
 134       - Y