Commit b315a63b authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

[media] pixfmt-packed-rgb.rst: adjust tables to fit in LaTeX

Adjust the tables to fit at the LaTeX and PDF outputs.

I wrote a previous patch RFC to show the big table in landscape,
but it makes harder to read on displays.

So, instead, let's use the adjustbox to shrink the size of those
long tables, as the table size can still be visible on screen,
and it is a way better to read in horizontal position and
visible if printed.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent fdb45d73
......@@ -6,11 +6,6 @@
Packed RGB formats
******************
*man Packed RGB formats(2)*
Packed RGB formats
Description
===========
......@@ -19,9 +14,14 @@ graphics frame buffers. They occupy 8, 16, 24 or 32 bits per pixel.
These are all packed-pixel formats, meaning all the data for a pixel lie
next to each other in memory.
.. raw:: latex
\newline\newline\begin{adjustbox}{width=\columnwidth}
.. _rgb-formats:
.. tabularcolumns:: |p{4.5cm}|p{3.3cm}|p{0.7cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{1.7cm}|
.. flat-table:: Packed RGB Image Formats
:header-rows: 2
:stub-columns: 0
......@@ -945,8 +945,11 @@ next to each other in memory.
- b\ :sub:`0`
.. raw:: latex
\end{adjustbox}\newline\newline
Bit 7 is the most significant bit.
.. note:: Bit 7 is the most significant bit.
The usage and value of the alpha bits (a) in the ARGB and ABGR formats
(collectively referred to as alpha formats) depend on the device type
......@@ -976,13 +979,16 @@ devices and drivers must ignore those bits, for both
Each cell is one byte.
.. raw:: latex
.. tabularcolumns:: |p{2.5cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{0.7cm}|
\newline\newline\begin{adjustbox}{width=\columnwidth}
.. flat-table::
.. tabularcolumns:: |p{4.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.1cm}|p{1.3cm}|
.. flat-table:: RGB byte order
:header-rows: 0
:stub-columns: 0
:widths: 2 1 1 1 1 1 1 1 1 1 1 1 1
:widths: 11 3 3 3 3 3 3 3 3 3 3 3 3
- .. row 1
......@@ -1097,6 +1103,9 @@ Each cell is one byte.
- R\ :sub:`33`
.. raw:: latex
\end{adjustbox}\newline\newline
Formats defined in :ref:`rgb-formats-deprecated` are deprecated and
must not be used by new drivers. They are documented here for reference.
......@@ -1106,6 +1115,13 @@ either the corresponding ARGB or XRGB format, depending on the driver.
.. _rgb-formats-deprecated:
.. raw:: latex
\newline\newline
\begin{adjustbox}{width=\columnwidth}
.. tabularcolumns:: |p{4.2cm}|p{1.0cm}|p{0.7cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{1.7cm}|
.. flat-table:: Deprecated Packed RGB Image Formats
:header-rows: 2
:stub-columns: 0
......@@ -1470,6 +1486,9 @@ either the corresponding ARGB or XRGB format, depending on the driver.
- b\ :sub:`0`
.. raw:: latex
\end{adjustbox}\newline\newline
A test utility to determine which RGB formats a driver actually supports
is available from the LinuxTV v4l-dvb repository. See
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment