Commit af4f4505 authored by Laurent Pinchart's avatar Laurent Pinchart Committed by Mauro Carvalho Chehab
Browse files

media: doc: pixfmt-yuv: Move all luma-only YUV formats to common file 



Luma-only pixel formats are documented in separate files. This
duplicates information, as those formats share comon traits. Consolidate
them in a single file and describe them in a single table.

Signed-off-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: default avatarHans Verkuil <hverkuil-cisco@xs4all.nl>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
parent 4bfc1688

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

deleted100644 → 0
+0 −44
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later



.. _V4L2-PIX-FMT-GREY:



**************************

V4L2_PIX_FMT_GREY ('GREY')

**************************



Grey-scale image





Description

===========



This is a grey-scale image. It is really a degenerate Y'CbCr format

which simply contains no Cb or Cr data.



**Byte Order.**

Each cell is one byte.



.. flat-table::

    :header-rows:  0

    :stub-columns: 0



    * - start + 0:

      - Y'\ :sub:`00`

      - Y'\ :sub:`01`

      - Y'\ :sub:`02`

      - Y'\ :sub:`03`

    * - start + 4:

      - Y'\ :sub:`10`

      - Y'\ :sub:`11`

      - Y'\ :sub:`12`

      - Y'\ :sub:`13`

    * - start + 8:

      - Y'\ :sub:`20`

      - Y'\ :sub:`21`

      - Y'\ :sub:`22`

      - Y'\ :sub:`23`

    * - start + 12:

      - Y'\ :sub:`30`

      - Y'\ :sub:`31`

      - Y'\ :sub:`32`

      - Y'\ :sub:`33`

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

deleted100644 → 0
+0 −65
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later



.. _V4L2-PIX-FMT-Y10:



*************************

V4L2_PIX_FMT_Y10 ('Y10 ')

*************************





Grey-scale image





Description

===========



This is a grey-scale image with a depth of 10 bits per pixel. Pixels are

stored in 16-bit words with unused high bits padded with 0. The least

significant byte is stored at lower memory addresses (little-endian).



**Byte Order.**

Each cell is one byte.









.. flat-table::

    :header-rows:  0

    :stub-columns: 0



    * - start + 0:

      - Y'\ :sub:`00low`

      - Y'\ :sub:`00high`

      - Y'\ :sub:`01low`

      - Y'\ :sub:`01high`

      - Y'\ :sub:`02low`

      - Y'\ :sub:`02high`

      - Y'\ :sub:`03low`

      - Y'\ :sub:`03high`

    * - start + 8:

      - Y'\ :sub:`10low`

      - Y'\ :sub:`10high`

      - Y'\ :sub:`11low`

      - Y'\ :sub:`11high`

      - Y'\ :sub:`12low`

      - Y'\ :sub:`12high`

      - Y'\ :sub:`13low`

      - Y'\ :sub:`13high`

    * - start + 16:

      - Y'\ :sub:`20low`

      - Y'\ :sub:`20high`

      - Y'\ :sub:`21low`

      - Y'\ :sub:`21high`

      - Y'\ :sub:`22low`

      - Y'\ :sub:`22high`

      - Y'\ :sub:`23low`

      - Y'\ :sub:`23high`

    * - start + 24:

      - Y'\ :sub:`30low`

      - Y'\ :sub:`30high`

      - Y'\ :sub:`31low`

      - Y'\ :sub:`31high`

      - Y'\ :sub:`32low`

      - Y'\ :sub:`32high`

      - Y'\ :sub:`33low`

      - Y'\ :sub:`33high`

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

deleted100644 → 0
+0 −33
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later



.. _V4L2-PIX-FMT-Y10BPACK:



******************************

V4L2_PIX_FMT_Y10BPACK ('Y10B')

******************************



Grey-scale image as a bit-packed array





Description

===========



This is a packed grey-scale image format with a depth of 10 bits per

pixel. Pixels are stored in a bit-packed array of 10bit bits per pixel,

with no padding between them and with the most significant bits coming

first from the left.



**Bit-packed representation.**



pixels cross the byte boundary and have a ratio of 5 bytes for each 4

pixels.



.. flat-table::

    :header-rows:  0

    :stub-columns: 0



    * - Y'\ :sub:`00[9:2]`

      - Y'\ :sub:`00[1:0]`\ Y'\ :sub:`01[9:4]`

      - Y'\ :sub:`01[3:0]`\ Y'\ :sub:`02[9:6]`

      - Y'\ :sub:`02[5:0]`\ Y'\ :sub:`03[9:8]`

      - Y'\ :sub:`03[7:0]`

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

deleted100644 → 0
+0 −43
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later



.. _V4L2-PIX-FMT-Y10P:



******************************

V4L2_PIX_FMT_Y10P ('Y10P')

******************************



Grey-scale image as a MIPI RAW10 packed array





Description

===========



This is a packed grey-scale image format with a depth of 10 bits per

pixel. Every four consecutive pixels are packed into 5 bytes. Each of

the first 4 bytes contain the 8 high order bits of the pixels, and

the 5th byte contains the 2 least significants bits of each pixel,

in the same order.



**Bit-packed representation.**



.. raw:: latex



    \small



.. tabularcolumns:: |p{1.2cm}||p{1.2cm}||p{1.2cm}||p{1.2cm}|p{3.2cm}|p{3.2cm}|



.. flat-table::

    :header-rows:  0

    :stub-columns: 0

    :widths: 8 8 8 8 64



    * - Y'\ :sub:`00[9:2]`

      - Y'\ :sub:`01[9:2]`

      - Y'\ :sub:`02[9:2]`

      - Y'\ :sub:`03[9:2]`

      - Y'\ :sub:`03[1:0]`\ (bits 7--6) Y'\ :sub:`02[1:0]`\ (bits 5--4)

	Y'\ :sub:`01[1:0]`\ (bits 3--2) Y'\ :sub:`00[1:0]`\ (bits 1--0)



.. raw:: latex



    \normalsize

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

deleted100644 → 0
+0 −65
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later



.. _V4L2-PIX-FMT-Y12:



*************************

V4L2_PIX_FMT_Y12 ('Y12 ')

*************************





Grey-scale image





Description

===========



This is a grey-scale image with a depth of 12 bits per pixel. Pixels are

stored in 16-bit words with unused high bits padded with 0. The least

significant byte is stored at lower memory addresses (little-endian).



**Byte Order.**

Each cell is one byte.









.. flat-table::

    :header-rows:  0

    :stub-columns: 0



    * - start + 0:

      - Y'\ :sub:`00low`

      - Y'\ :sub:`00high`

      - Y'\ :sub:`01low`

      - Y'\ :sub:`01high`

      - Y'\ :sub:`02low`

      - Y'\ :sub:`02high`

      - Y'\ :sub:`03low`

      - Y'\ :sub:`03high`

    * - start + 8:

      - Y'\ :sub:`10low`

      - Y'\ :sub:`10high`

      - Y'\ :sub:`11low`

      - Y'\ :sub:`11high`

      - Y'\ :sub:`12low`

      - Y'\ :sub:`12high`

      - Y'\ :sub:`13low`

      - Y'\ :sub:`13high`

    * - start + 16:

      - Y'\ :sub:`20low`

      - Y'\ :sub:`20high`

      - Y'\ :sub:`21low`

      - Y'\ :sub:`21high`

      - Y'\ :sub:`22low`

      - Y'\ :sub:`22high`

      - Y'\ :sub:`23low`

      - Y'\ :sub:`23high`

    * - start + 24:

      - Y'\ :sub:`30low`

      - Y'\ :sub:`30high`

      - Y'\ :sub:`31low`

      - Y'\ :sub:`31high`

      - Y'\ :sub:`32low`

      - Y'\ :sub:`32high`

      - Y'\ :sub:`33low`

      - Y'\ :sub:`33high`