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

   1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
   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     * - start0 + 0:
  46       - Y'\ :sub:`00`
  47       - Y'\ :sub:`01`
  48       - Y'\ :sub:`02`
  49       - Y'\ :sub:`03`
  50     * - start0 + 4:
  51       - Y'\ :sub:`10`
  52       - Y'\ :sub:`11`
  53       - Y'\ :sub:`12`
  54       - Y'\ :sub:`13`
  55     * - start0 + 8:
  56       - Y'\ :sub:`20`
  57       - Y'\ :sub:`21`
  58       - Y'\ :sub:`22`
  59       - Y'\ :sub:`23`
  60     * - start0 + 12:
  61       - Y'\ :sub:`30`
  62       - Y'\ :sub:`31`
  63       - Y'\ :sub:`32`
  64       - Y'\ :sub:`33`
  65     * -
  66     * - start1 + 0:
  67       - Cb\ :sub:`00`
  68       - Cb\ :sub:`01`
  69       - Cb\ :sub:`02`
  70       - Cb\ :sub:`03`
  71     * - start1 + 4:
  72       - Cb\ :sub:`10`
  73       - Cb\ :sub:`11`
  74       - Cb\ :sub:`12`
  75       - Cb\ :sub:`13`
  76     * - start1 + 8:
  77       - Cb\ :sub:`20`
  78       - Cb\ :sub:`21`
  79       - Cb\ :sub:`22`
  80       - Cb\ :sub:`23`
  81     * - start1 + 12:
  82       - Cb\ :sub:`20`
  83       - Cb\ :sub:`21`
  84       - Cb\ :sub:`32`
  85       - Cb\ :sub:`33`
  86     * -
  87     * - start2 + 0:
  88       - Cr\ :sub:`00`
  89       - Cr\ :sub:`01`
  90       - Cr\ :sub:`02`
  91       - Cr\ :sub:`03`
  92     * - start2 + 4:
  93       - Cr\ :sub:`10`
  94       - Cr\ :sub:`11`
  95       - Cr\ :sub:`12`
  96       - Cr\ :sub:`13`
  97     * - start2 + 8:
  98       - Cr\ :sub:`20`
  99       - Cr\ :sub:`21`
 100       - Cr\ :sub:`22`
 101       - Cr\ :sub:`23`
 102     * - start2 + 12:
 103       - Cr\ :sub:`30`
 104       - Cr\ :sub:`31`
 105       - Cr\ :sub:`32`
 106       - Cr\ :sub:`33`
 107
 108
 109 **Color Sample Location:**
 110
 111
 112
 113 .. flat-table::
 114     :header-rows:  0
 115     :stub-columns: 0
 116
 117     * -
 118       - 0
 119       - 1
 120       - 2
 121       - 3
 122     * - 0
 123       - YC
 124       - YC
 125       - YC
 126       - YC
 127     * - 1
 128       - YC
 129       - YC
 130       - YC
 131       - YC
 132     * - 2
 133       - YC
 134       - YC
 135       - YC
 136       - YC
 137     * - 3
 138       - YC
 139       - YC
 140       - YC
 141       - YC