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

media: doc: pixfmt-rgb: Make 8 bits per component table more compact 



All formats using 8 bits per component can be described with a byte
granularity instead of a bit granularity without loss of precision. This
makes the corresponding table more compact and easier to read.

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 e9a66489

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

+40 −371
Original line number Diff line number Diff line
@@ -659,440 +659,109 @@ nomenclature that instead use the order of components as seen in a 24- or 
    \tiny

    \setlength{\tabcolsep}{2pt}



.. tabularcolumns:: |p{2.8cm}|p{2.0cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|

.. tabularcolumns:: |p{2.8cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|p{2.0cm}|





.. flat-table:: RGB Formats With 8 Bits Per Component

    :header-rows:  2

    :header-rows:  1

    :stub-columns: 0



    * - Identifier

      - Code

      - :cspan:`7` Byte 0 in memory

      - :cspan:`7` Byte 1

      - :cspan:`7` Byte 2

      - :cspan:`7` Byte 3

    * -

      -

      - 7

      - 6

      - 5

      - 4

      - 3

      - 2

      - 1

      - 0



      - 7

      - 6

      - 5

      - 4

      - 3

      - 2

      - 1

      - 0



      - 7

      - 6

      - 5

      - 4

      - 3

      - 2

      - 1

      - 0



      - 7

      - 6

      - 5

      - 4

      - 3

      - 2

      - 1

      - 0

      - Byte 0 in memory

      - Byte 1

      - Byte 2

      - Byte 3

    * .. _V4L2-PIX-FMT-BGR24:



      - ``V4L2_PIX_FMT_BGR24``

      - 'BGR3'



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`

      - R\ :sub:`7-0`

      -

    * .. _V4L2-PIX-FMT-RGB24:



      - ``V4L2_PIX_FMT_RGB24``

      - 'RGB3'



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`

      - R\ :sub:`7-0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`

      -

    * .. _V4L2-PIX-FMT-ABGR32:



      - ``V4L2_PIX_FMT_ABGR32``

      - 'AR24'



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - a\ :sub:`7`

      - a\ :sub:`6`

      - a\ :sub:`5`

      - a\ :sub:`4`

      - a\ :sub:`3`

      - a\ :sub:`2`

      - a\ :sub:`1`

      - a\ :sub:`0`

      - B\ :sub:`7-0`

      - G\ :sub:`7-0`

      - R\ :sub:`7-0`

      - A\ :sub:`7-0`

    * .. _V4L2-PIX-FMT-XBGR32:



      - ``V4L2_PIX_FMT_XBGR32``

      - 'XR24'



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - B\ :sub:`7-0`

      - G\ :sub:`7-0`

      - R\ :sub:`7-0`

      - `-`

    * .. _V4L2-PIX-FMT-BGRA32:



      - ``V4L2_PIX_FMT_BGRA32``

      - 'RA24'



      - a\ :sub:`7`

      - a\ :sub:`6`

      - a\ :sub:`5`

      - a\ :sub:`4`

      - a\ :sub:`3`

      - a\ :sub:`2`

      - a\ :sub:`1`

      - a\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`

      - A\ :sub:`7-0`

      - B\ :sub:`7-0`

      - G\ :sub:`7-0`

      - R\ :sub:`7-0`

    * .. _V4L2-PIX-FMT-BGRX32:



      - ``V4L2_PIX_FMT_BGRX32``

      - 'RX24'



      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`

      - B\ :sub:`7-0`

      - G\ :sub:`7-0`

      - R\ :sub:`7-0`

    * .. _V4L2-PIX-FMT-RGBA32:



      - ``V4L2_PIX_FMT_RGBA32``

      - 'AB24'



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - a\ :sub:`7`

      - a\ :sub:`6`

      - a\ :sub:`5`

      - a\ :sub:`4`

      - a\ :sub:`3`

      - a\ :sub:`2`

      - a\ :sub:`1`

      - a\ :sub:`0`

      - R\ :sub:`7-0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`

      - A\ :sub:`7-0`

    * .. _V4L2-PIX-FMT-RGBX32:



      - ``V4L2_PIX_FMT_RGBX32``

      - 'XB24'



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`



      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - R\ :sub:`7-0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`

      - `-`

    * .. _V4L2-PIX-FMT-ARGB32:



      - ``V4L2_PIX_FMT_ARGB32``

      - 'BA24'



      - a\ :sub:`7`

      - a\ :sub:`6`

      - a\ :sub:`5`

      - a\ :sub:`4`

      - a\ :sub:`3`

      - a\ :sub:`2`

      - a\ :sub:`1`

      - a\ :sub:`0`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`

      - A\ :sub:`7-0`

      - R\ :sub:`7-0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`

    * .. _V4L2-PIX-FMT-XRGB32:



      - ``V4L2_PIX_FMT_XRGB32``

      - 'BX24'



      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`

      - `-`



      - r\ :sub:`7`

      - r\ :sub:`6`

      - r\ :sub:`5`

      - r\ :sub:`4`

      - r\ :sub:`3`

      - r\ :sub:`2`

      - r\ :sub:`1`

      - r\ :sub:`0`



      - g\ :sub:`7`

      - g\ :sub:`6`

      - g\ :sub:`5`

      - g\ :sub:`4`

      - g\ :sub:`3`

      - g\ :sub:`2`

      - g\ :sub:`1`

      - g\ :sub:`0`



      - b\ :sub:`7`

      - b\ :sub:`6`

      - b\ :sub:`5`

      - b\ :sub:`4`

      - b\ :sub:`3`

      - b\ :sub:`2`

      - b\ :sub:`1`

      - b\ :sub:`0`

      - R\ :sub:`7-0`

      - G\ :sub:`7-0`

      - B\ :sub:`7-0`



.. raw:: latex