1 .. -*- coding: utf-8; mode: rst -*-
9 *man Packed RGB formats(2)*
17 These formats are designed to match the pixel formats of typical PC
18 graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel.
19 These are all packed-pixel formats, meaning all the data for a pixel lie
20 next to each other in memory.
25 .. flat-table:: Packed RGB Image Formats
37 - :cspan:`7` Byte 0 in memory
118 - .. _`V4L2-PIX-FMT-RGB332`:
120 - ``V4L2_PIX_FMT_RGB332``
141 - .. _`V4L2-PIX-FMT-ARGB444`:
143 - ``V4L2_PIX_FMT_ARGB444``
181 - .. _`V4L2-PIX-FMT-XRGB444`:
183 - ``V4L2_PIX_FMT_XRGB444``
221 - .. _`V4L2-PIX-FMT-ARGB555`:
223 - ``V4L2_PIX_FMT_ARGB555``
261 - .. _`V4L2-PIX-FMT-XRGB555`:
263 - ``V4L2_PIX_FMT_XRGB555``
301 - .. _`V4L2-PIX-FMT-RGB565`:
303 - ``V4L2_PIX_FMT_RGB565``
341 - .. _`V4L2-PIX-FMT-ARGB555X`:
343 - ``V4L2_PIX_FMT_ARGB555X``
381 - .. _`V4L2-PIX-FMT-XRGB555X`:
383 - ``V4L2_PIX_FMT_XRGB555X``
421 - .. _`V4L2-PIX-FMT-RGB565X`:
423 - ``V4L2_PIX_FMT_RGB565X``
461 - .. _`V4L2-PIX-FMT-BGR24`:
463 - ``V4L2_PIX_FMT_BGR24``
518 - .. _`V4L2-PIX-FMT-RGB24`:
520 - ``V4L2_PIX_FMT_RGB24``
575 - .. _`V4L2-PIX-FMT-BGR666`:
577 - ``V4L2_PIX_FMT_BGR666``
649 - .. _`V4L2-PIX-FMT-ABGR32`:
651 - ``V4L2_PIX_FMT_ABGR32``
723 - .. _`V4L2-PIX-FMT-XBGR32`:
725 - ``V4L2_PIX_FMT_XBGR32``
797 - .. _`V4L2-PIX-FMT-ARGB32`:
799 - ``V4L2_PIX_FMT_ARGB32``
871 - .. _`V4L2-PIX-FMT-XRGB32`:
873 - ``V4L2_PIX_FMT_XRGB32``
946 Bit 7 is the most significant bit.
948 The usage and value of the alpha bits (a) in the ARGB and ABGR formats
949 (collectively referred to as alpha formats) depend on the device type
950 and hardware operation. :ref:`Capture <capture>` devices (including
951 capture queues of mem-to-mem devices) fill the alpha component in
952 memory. When the device outputs an alpha channel the alpha component
953 will have a meaningful value. Otherwise, when the device doesn't output
954 an alpha channel but can set the alpha bit to a user-configurable value,
955 the :ref:`V4L2_CID_ALPHA_COMPONENT <v4l2-alpha-component>` control
956 is used to specify that alpha value, and the alpha component of all
957 pixels will be set to the value specified by that control. Otherwise a
958 corresponding format without an alpha component (XRGB or XBGR) must be
959 used instead of an alpha format.
961 :ref:`Output <output>` devices (including output queues of mem-to-mem
962 devices and :ref:`video output overlay <osd>` devices) read the alpha
963 component from memory. When the device processes the alpha channel the
964 alpha component must be filled with meaningful values by applications.
965 Otherwise a corresponding format without an alpha component (XRGB or
966 XBGR) must be used instead of an alpha format.
968 The XRGB and XBGR formats contain undefined bits (-). Applications,
969 devices and drivers must ignore those bits, for both
970 :ref:`capture` and :ref:`output` devices.
973 Each cell is one byte.
980 :widths: 2 1 1 1 1 1 1 1 1 1 1 1 1
1096 Formats defined in :ref:`rgb-formats-deprecated` are deprecated and
1097 must not be used by new drivers. They are documented here for reference.
1098 The meaning of their alpha bits (a) is ill-defined and interpreted as in
1099 either the corresponding ARGB or XRGB format, depending on the driver.
1102 .. _rgb-formats-deprecated:
1104 .. flat-table:: Deprecated Packed RGB Image Formats
1116 - :cspan:`7` Byte 0 in memory
1197 - .. _`V4L2-PIX-FMT-RGB444`:
1199 - ``V4L2_PIX_FMT_RGB444``
1237 - .. _`V4L2-PIX-FMT-RGB555`:
1239 - ``V4L2_PIX_FMT_RGB555``
1277 - .. _`V4L2-PIX-FMT-RGB555X`:
1279 - ``V4L2_PIX_FMT_RGB555X``
1317 - .. _`V4L2-PIX-FMT-BGR32`:
1319 - ``V4L2_PIX_FMT_BGR32``
1391 - .. _`V4L2-PIX-FMT-RGB32`:
1393 - ``V4L2_PIX_FMT_RGB32``
1466 A test utility to determine which RGB formats a driver actually supports
1467 is available from the LinuxTV v4l-dvb repository. See
1468 `https://linuxtv.org/repo/ <https://linuxtv.org/repo/>`__ for access