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

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