First part of LaTeX build fixes for the media book
Subsystems (2)
cover First part of LaTeX build fixes for the media book
This one fix most of the issues with LaTeX output for the media book at the V4L2 book, before "Function Reference". So, up to page 181 of a 969 pages document.
There are still some things that I was not able to fix on this set:
- the ".. notes::" tag inside a table column are getting the wrong size. This should be fixable by rewriting a LaTeX code at conf.py, but I was unable to do that, as I'm not familiar with LaTeX syntax. Tried some things, but gave up as it was taking a lot of time. So, I just moved on to other things;
- The Sphinx ReST tables are incomplete for LaTeX. There are several missing features:
1) All LaTeX tables with a line bigger than \columwidth require an extra tag to describe column widthes (.. tabularcolumns::). Without that, it will assume that all columns are the same. The :widths: parameter of flat-table is silently ignored;
2) LaTex tables bigger than one page explicitly require a tag (.. cssclass:: longtable). Without that, the table will avance 'till the end of the page;
3) Too wide tables require to use LaTeX adjustbox extension. As Sphinx doesn't have support for it, the code should add a hack (via .. raw::
latex)
4) I got two tables where the latex tag (.. raw:: latex) didn't work. No idea why.
5) Now, several tables have several tags to initialize a table:
.. raw:: latex
\newline\newline\begin{adjustbox}{width=\columnwidth}
.. tabularcolumns:: |p{7.6cm}|p{1.6cm}|p{0.7cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|
.. _v4l2-mbus-pixelcode-bayer:
.. cssclass: longtable
.. flat-table:: Bayer Formats
...
The order where those things happen matter. if the order gets wrong, the tag won't do what it was expected to do.
If I got it right, cssclass should happen just before flat-table. If the table has a tag, it should be after tabularcolumns. The raw::latex seems to happen before all other tags.
There are also some troubles with Sphinx build system related to PDF generation:
- It doesn't honour SPHINXDIRS when building PDF/LaTeX files;
- Sometimes, the flat-table extension crashes, when the ":widths:" or ".. tabularcolumns::" doesn't match the size of a table. When this happens, it produces an incomplete LaTeX file until removing the contents of Documentation/output.
I'll continue working on the LaTeX output fixups. I'll later check how to solve the huge amount of warnings it outputs.
-
That's said, IMHO, the LaTeX/PDF output is very nice, as we can have everything into a single file, and the output is great, IMHO.
Once the tables are resized with adjustbox, it is even easier to read than HTML, as we can see the entire table altogether without needing to scroll on the big ones.
Markus,
It would be great if you could look on the above issues for us and see what could be done to improve it.
Mauro Carvalho Chehab (20):
[media] docs-rst: re-generate typical_media_device.pdf [media] docs-rst: add tabularcolumns to all tables
[media] control.rst: Fix table width
[media] extended-controls.rst: fix table sizes
[media] docs-rst: add column hints for pixfmt-002 and pixfmt-006 [media] pixfmt-packed-rgb.rst: Fix cell spans
[media] pixfmt-packed-rgb.rst: adjust tables to fit in LaTeX [media] pixfmt-packed-yuv.rst: adjust tables to fit in LaTeX [media] docs-rst: remove width hints from pixfmt byte order tables [media] buffer.rst: Adjust table columns for LaTeX output [media] dev-overlay.rst: don't ident a note
[media] dev-raw-vbi.rst: add a footnote for the count limits [media] dev-raw-vbi.rst: adjust table columns for LaTeX output [media] docs-rst: re-generate vbi_525.pdf and vbi_625.pdf [media] dev-sliced-vbi.rst: use a footnote for VBI images [media] dev-sliced-vbi.rst: Adjust tables on LaTeX output [media] dev-rds.rst: adjust table dimentions for LaTeX [media] dev-subdev.rst: make table fully visible on LaTeX [media] subdev-formats.rst: adjust most of the tables to fill in page [media] diff-v4l.rst: Make capabilities table fit in LaTeX
.../media/media_api_files/typical_media_device.pdf | Bin 134268 -> 52895 bytes .../media/uapi/cec/cec-ioc-adap-g-caps.rst | 4 + .../media/uapi/cec/cec-ioc-adap-g-log-addrs.rst | 10 + Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 10 + Documentation/media/uapi/cec/cec-ioc-g-mode.rst | 6 + Documentation/media/uapi/cec/cec-ioc-receive.rst | 6 + .../media/uapi/dvb/fe-diseqc-recv-slave-reply.rst | 2 + .../media/uapi/dvb/fe-diseqc-send-master-cmd.rst | 2 + Documentation/media/uapi/dvb/fe-get-info.rst | 2 + Documentation/media/uapi/dvb/fe-type-t.rst | 2 + Documentation/media/uapi/gen-errors.rst | 2 + .../media/uapi/mediactl/media-ioc-device-info.rst | 2 + .../uapi/mediactl/media-ioc-enum-entities.rst | 2 + .../media/uapi/mediactl/media-ioc-enum-links.rst | 6 + .../media/uapi/mediactl/media-ioc-g-topology.rst | 12 + Documentation/media/uapi/rc/rc-tables.rst | 2 + Documentation/media/uapi/v4l/buffer.rst | 28 +- Documentation/media/uapi/v4l/control.rst | 4 +- Documentation/media/uapi/v4l/dev-overlay.rst | 10 +- Documentation/media/uapi/v4l/dev-raw-vbi.rst | 16 +- .../media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf | Bin 3395 -> 3706 bytes .../media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf | Bin 3683 -> 3996 bytes Documentation/media/uapi/v4l/dev-rds.rst | 6 + Documentation/media/uapi/v4l/dev-sdr.rst | 2 + Documentation/media/uapi/v4l/dev-sliced-vbi.rst | 50 +- Documentation/media/uapi/v4l/dev-subdev.rst | 9 + Documentation/media/uapi/v4l/diff-v4l.rst | 4 +- Documentation/media/uapi/v4l/extended-controls.rst | 63 +- Documentation/media/uapi/v4l/field-order.rst | 2 + Documentation/media/uapi/v4l/pixfmt-002.rst | 4 + Documentation/media/uapi/v4l/pixfmt-003.rst | 4 + Documentation/media/uapi/v4l/pixfmt-006.rst | 5 + Documentation/media/uapi/v4l/pixfmt-007.rst | 18 + Documentation/media/uapi/v4l/pixfmt-013.rst | 2 + Documentation/media/uapi/v4l/pixfmt-grey.rst | 5 - Documentation/media/uapi/v4l/pixfmt-m420.rst | 4 - Documentation/media/uapi/v4l/pixfmt-nv12.rst | 4 - Documentation/media/uapi/v4l/pixfmt-nv12m.rst | 3 - Documentation/media/uapi/v4l/pixfmt-nv12mt.rst | 2 - Documentation/media/uapi/v4l/pixfmt-nv16.rst | 5 - Documentation/media/uapi/v4l/pixfmt-nv16m.rst | 5 - Documentation/media/uapi/v4l/pixfmt-nv24.rst | 5 - Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 115 +- Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst | 26 +- Documentation/media/uapi/v4l/pixfmt-reserved.rst | 4 + Documentation/media/uapi/v4l/pixfmt-sbggr16.rst | 6 - Documentation/media/uapi/v4l/pixfmt-sbggr8.rst | 4 - Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst | 5 - Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst | 5 - Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst | 6 - Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst | 4 - Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-srggb10.rst | 3 +- .../media/uapi/v4l/pixfmt-srggb10alaw8.rst | 2 - Documentation/media/uapi/v4l/pixfmt-srggb10p.rst | 12 +- Documentation/media/uapi/v4l/pixfmt-srggb12.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-srggb8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-uv8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-uyvy.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-vyuy.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y10.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y10b.rst | 6 - Documentation/media/uapi/v4l/pixfmt-y12.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y12i.rst | 3 - Documentation/media/uapi/v4l/pixfmt-y16-be.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y16.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y41p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y8i.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv410.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv411p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv420.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv420m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv422m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv422p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv444m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuyv.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yvyu.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-z16.rst | 3 +- Documentation/media/uapi/v4l/subdev-formats.rst | 5577 ++++++++++---------- .../media/uapi/v4l/vidioc-create-bufs.rst | 2 + Documentation/media/uapi/v4l/vidioc-cropcap.rst | 4 + .../media/uapi/v4l/vidioc-dbg-g-chip-info.rst | 6 + .../media/uapi/v4l/vidioc-dbg-g-register.rst | 4 + .../media/uapi/v4l/vidioc-decoder-cmd.rst | 4 + Documentation/media/uapi/v4l/vidioc-dqevent.rst | 18 + .../media/uapi/v4l/vidioc-dv-timings-cap.rst | 4 + .../media/uapi/v4l/vidioc-encoder-cmd.rst | 6 + .../media/uapi/v4l/vidioc-enum-dv-timings.rst | 2 + Documentation/media/uapi/v4l/vidioc-enum-fmt.rst | 4 + .../media/uapi/v4l/vidioc-enum-frameintervals.rst | 4 + .../media/uapi/v4l/vidioc-enum-framesizes.rst | 6 + .../media/uapi/v4l/vidioc-enum-freq-bands.rst | 4 + Documentation/media/uapi/v4l/vidioc-enuminput.rst | 6 + Documentation/media/uapi/v4l/vidioc-enumoutput.rst | 6 + Documentation/media/uapi/v4l/vidioc-enumstd.rst | 6 + Documentation/media/uapi/v4l/vidioc-expbuf.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-audio.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-audioout.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-crop.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-ctrl.rst | 2 + .../media/uapi/v4l/vidioc-g-dv-timings.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-edid.rst | 2 + .../media/uapi/v4l/vidioc-g-enc-index.rst | 6 + .../media/uapi/v4l/vidioc-g-ext-ctrls.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-fbuf.rst | 6 + .../media/uapi/v4l/vidioc-g-frequency.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst | 4 + .../media/uapi/v4l/vidioc-g-modulator.rst | 4 + Documentation/media/uapi/v4l/vidioc-g-parm.rst | 10 + Documentation/media/uapi/v4l/vidioc-g-priority.rst | 2 + .../media/uapi/v4l/vidioc-g-selection.rst | 2 + .../media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst | 4 + Documentation/media/uapi/v4l/vidioc-g-tuner.rst | 8 + Documentation/media/uapi/v4l/vidioc-queryctrl.rst | 10 + Documentation/media/uapi/v4l/vidioc-reqbufs.rst | 2 + .../media/uapi/v4l/vidioc-s-hw-freq-seek.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-frame-interval.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-frame-size.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-mbus-code.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-crop.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-fmt.rst | 4 + .../uapi/v4l/vidioc-subdev-g-frame-interval.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-selection.rst | 2 + .../media/uapi/v4l/vidioc-subscribe-event.rst | 4 + 126 files changed, 3375 insertions(+), 3001 deletions(-)
--
2.7.4
Em Thu, 18 Aug 2016 13:15:29 -0300
Mauro Carvalho Chehab <[email protected]> escreveu:
Quoted 47 lines
This one fix most of the issues with LaTeX output for the media book at the V4L2 book, before "Function Reference". So, up to page 181 of a 969 pages document.
There are still some things that I was not able to fix on this set:
- the ".. notes::" tag inside a table column are getting the wrong size. This should be fixable by rewriting a LaTeX code at
conf.py, but I was unable to do that, as I'm not familiar with LaTeX syntax. Tried some things, but gave up as it was taking a lot of time. So, I just moved on to other things;- The Sphinx ReST tables are incomplete for LaTeX. There are several missing features:
1) All LaTeX tables with a line bigger than \columwidth require an extra tag to describe column widthes (.. tabularcolumns::). Without that, it will assume that all columns are the same. The :widths: parameter of flat-table is silently ignored;
2) LaTex tables bigger than one page explicitly require a tag (.. cssclass:: longtable). Without that, the table will avance 'till the end of the page;
3) Too wide tables require to use LaTeX adjustbox extension. As Sphinx doesn't have support for it, the code should add a hack (via .. raw::
latex)4) I got two tables where the latex tag (.. raw:: latex) didn't work. No idea why.
5) Now, several tables have several tags to initialize a table:
.. raw:: latex \newline\newline\begin{adjustbox}{width=\columnwidth} .. tabularcolumns:: |p{7.6cm}|p{1.6cm}|p{0.7cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|
.. _v4l2-mbus-pixelcode-bayer:
.. cssclass: longtable
.. flat-table:: Bayer Formats
...
Quoted 6 lines
The order where those things happen matter. if the order gets wrong, the tag won't do what it was expected to do.
If I got it right, cssclass should happen just before flat-table. If the table has a tag, it should be after tabularcolumns. The
raw::latexseems to happen before all other tags.
There is one additional issue I forgot to mention: when cell spans are used, on the spanned cell, LaTeX does the wrong thing:
sometimes, it expects manual line breaks. Also, it doesn't justify the spanned columns.
Quoted 180 lines
There are also some troubles with Sphinx build system related to PDF generation:
- It doesn't honour SPHINXDIRS when building PDF/LaTeX files;
- Sometimes, the flat-table extension crashes, when the ":widths:" or ".. tabularcolumns::" doesn't match the size of a table. When this happens, it produces an incomplete LaTeX file until removing the contents of
Documentation/output.I'll continue working on the LaTeX output fixups. I'll later check how to solve the huge amount of warnings it outputs.
-
That's said, IMHO, the LaTeX/PDF output is very nice, as we can have everything into a single file, and the output is great, IMHO.
Once the tables are resized with adjustbox, it is even easier to read than HTML, as we can see the entire table altogether without needing to scroll on the big ones.
Markus,
It would be great if you could look on the above issues for us and see what could be done to improve it.
Mauro Carvalho Chehab (20):
[media] docs-rst: re-generate typical_media_device.pdf [media] docs-rst: add tabularcolumns to all tables
[media]control.rst: Fix table width
[media]extended-controls.rst: fix table sizes
[media] docs-rst: add column hints for pixfmt-002 and pixfmt-006 [media]pixfmt-packed-rgb.rst: Fix cell spans
[media]pixfmt-packed-rgb.rst: adjust tables to fit in LaTeX [media]pixfmt-packed-yuv.rst: adjust tables to fit in LaTeX [media] docs-rst: remove width hints from pixfmt byte order tables [media]buffer.rst: Adjust table columns for LaTeX output [media]dev-overlay.rst: don't ident a note
[media]dev-raw-vbi.rst: add a footnote for the count limits [media]dev-raw-vbi.rst: adjust table columns for LaTeX output [media] docs-rst: re-generate vbi_525.pdf and vbi_625.pdf [media]dev-sliced-vbi.rst: use a footnote for VBI images [media]dev-sliced-vbi.rst: Adjust tables on LaTeX output [media]dev-rds.rst: adjust table dimentions for LaTeX [media]dev-subdev.rst: make table fully visible on LaTeX [media]subdev-formats.rst: adjust most of the tables to fill in page [media]diff-v4l.rst: Make capabilities table fit in LaTeX.../media/media_api_files/typical_media_device.pdf | Bin 134268 -> 52895 bytes .../media/uapi/cec/cec-ioc-adap-g-caps.rst | 4 + .../media/uapi/cec/cec-ioc-adap-g-log-addrs.rst | 10 + Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 10 + Documentation/media/uapi/cec/cec-ioc-g-mode.rst | 6 + Documentation/media/uapi/cec/cec-ioc-receive.rst | 6 + .../media/uapi/dvb/fe-diseqc-recv-slave-reply.rst | 2 + .../media/uapi/dvb/fe-diseqc-send-master-cmd.rst | 2 + Documentation/media/uapi/dvb/fe-get-info.rst | 2 + Documentation/media/uapi/dvb/fe-type-t.rst | 2 + Documentation/media/uapi/gen-errors.rst | 2 + .../media/uapi/mediactl/media-ioc-device-info.rst | 2 + .../uapi/mediactl/media-ioc-enum-entities.rst | 2 + .../media/uapi/mediactl/media-ioc-enum-links.rst | 6 + .../media/uapi/mediactl/media-ioc-g-topology.rst | 12 + Documentation/media/uapi/rc/rc-tables.rst | 2 + Documentation/media/uapi/v4l/buffer.rst | 28 +- Documentation/media/uapi/v4l/control.rst | 4 +- Documentation/media/uapi/v4l/dev-overlay.rst | 10 +- Documentation/media/uapi/v4l/dev-raw-vbi.rst | 16 +- .../media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf | Bin 3395 -> 3706 bytes .../media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf | Bin 3683 -> 3996 bytes Documentation/media/uapi/v4l/dev-rds.rst | 6 + Documentation/media/uapi/v4l/dev-sdr.rst | 2 + Documentation/media/uapi/v4l/dev-sliced-vbi.rst | 50 +- Documentation/media/uapi/v4l/dev-subdev.rst | 9 + Documentation/media/uapi/v4l/diff-v4l.rst | 4 +- Documentation/media/uapi/v4l/extended-controls.rst | 63 +- Documentation/media/uapi/v4l/field-order.rst | 2 + Documentation/media/uapi/v4l/pixfmt-002.rst | 4 + Documentation/media/uapi/v4l/pixfmt-003.rst | 4 + Documentation/media/uapi/v4l/pixfmt-006.rst | 5 + Documentation/media/uapi/v4l/pixfmt-007.rst | 18 + Documentation/media/uapi/v4l/pixfmt-013.rst | 2 + Documentation/media/uapi/v4l/pixfmt-grey.rst | 5 - Documentation/media/uapi/v4l/pixfmt-m420.rst | 4 - Documentation/media/uapi/v4l/pixfmt-nv12.rst | 4 - Documentation/media/uapi/v4l/pixfmt-nv12m.rst | 3 - Documentation/media/uapi/v4l/pixfmt-nv12mt.rst | 2 - Documentation/media/uapi/v4l/pixfmt-nv16.rst | 5 - Documentation/media/uapi/v4l/pixfmt-nv16m.rst | 5 - Documentation/media/uapi/v4l/pixfmt-nv24.rst | 5 - Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 115 +- Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst | 26 +- Documentation/media/uapi/v4l/pixfmt-reserved.rst | 4 + Documentation/media/uapi/v4l/pixfmt-sbggr16.rst | 6 - Documentation/media/uapi/v4l/pixfmt-sbggr8.rst | 4 - Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst | 5 - Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst | 5 - Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst | 6 - Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst | 4 - Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-srggb10.rst | 3 +- .../media/uapi/v4l/pixfmt-srggb10alaw8.rst | 2 - Documentation/media/uapi/v4l/pixfmt-srggb10p.rst | 12 +- Documentation/media/uapi/v4l/pixfmt-srggb12.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-srggb8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-uv8.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-uyvy.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-vyuy.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y10.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y10b.rst | 6 - Documentation/media/uapi/v4l/pixfmt-y12.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y12i.rst | 3 - Documentation/media/uapi/v4l/pixfmt-y16-be.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y16.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y41p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-y8i.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv410.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv411p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv420.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv420m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv422m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv422p.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuv444m.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yuyv.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-yvyu.rst | 3 +- Documentation/media/uapi/v4l/pixfmt-z16.rst | 3 +- Documentation/media/uapi/v4l/subdev-formats.rst | 5577 ++++++++++---------- .../media/uapi/v4l/vidioc-create-bufs.rst | 2 + Documentation/media/uapi/v4l/vidioc-cropcap.rst | 4 + .../media/uapi/v4l/vidioc-dbg-g-chip-info.rst | 6 + .../media/uapi/v4l/vidioc-dbg-g-register.rst | 4 + .../media/uapi/v4l/vidioc-decoder-cmd.rst | 4 + Documentation/media/uapi/v4l/vidioc-dqevent.rst | 18 + .../media/uapi/v4l/vidioc-dv-timings-cap.rst | 4 + .../media/uapi/v4l/vidioc-encoder-cmd.rst | 6 + .../media/uapi/v4l/vidioc-enum-dv-timings.rst | 2 + Documentation/media/uapi/v4l/vidioc-enum-fmt.rst | 4 + .../media/uapi/v4l/vidioc-enum-frameintervals.rst | 4 + .../media/uapi/v4l/vidioc-enum-framesizes.rst | 6 + .../media/uapi/v4l/vidioc-enum-freq-bands.rst | 4 + Documentation/media/uapi/v4l/vidioc-enuminput.rst | 6 + Documentation/media/uapi/v4l/vidioc-enumoutput.rst | 6 + Documentation/media/uapi/v4l/vidioc-enumstd.rst | 6 + Documentation/media/uapi/v4l/vidioc-expbuf.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-audio.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-audioout.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-crop.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-ctrl.rst | 2 + .../media/uapi/v4l/vidioc-g-dv-timings.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-edid.rst | 2 + .../media/uapi/v4l/vidioc-g-enc-index.rst | 6 + .../media/uapi/v4l/vidioc-g-ext-ctrls.rst | 6 + Documentation/media/uapi/v4l/vidioc-g-fbuf.rst | 6 + .../media/uapi/v4l/vidioc-g-frequency.rst | 2 + Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst | 4 + .../media/uapi/v4l/vidioc-g-modulator.rst | 4 + Documentation/media/uapi/v4l/vidioc-g-parm.rst | 10 + Documentation/media/uapi/v4l/vidioc-g-priority.rst | 2 + .../media/uapi/v4l/vidioc-g-selection.rst | 2 + .../media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst | 4 + Documentation/media/uapi/v4l/vidioc-g-tuner.rst | 8 + Documentation/media/uapi/v4l/vidioc-queryctrl.rst | 10 + Documentation/media/uapi/v4l/vidioc-reqbufs.rst | 2 + .../media/uapi/v4l/vidioc-s-hw-freq-seek.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-frame-interval.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-frame-size.rst | 2 + .../uapi/v4l/vidioc-subdev-enum-mbus-code.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-crop.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-fmt.rst | 4 + .../uapi/v4l/vidioc-subdev-g-frame-interval.rst | 2 + .../media/uapi/v4l/vidioc-subdev-g-selection.rst | 2 + .../media/uapi/v4l/vidioc-subscribe-event.rst | 4 + 126 files changed, 3375 insertions(+), 3001 deletions(-)
Quoted 4 lines
--
2.7.4
Thanks,
Mauro
PATCH 1/20 docs-rst: re-generate typical_media_device.pdf
In reply to Mauro Carvalho ChehabThere are some texts there on the wrong place. Re-generate it from the svg file.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- .../media/media_api_files/typical_media_device.pdf | Bin 134268 -> 52895 bytes 1 file changed, 0 insertions(+), 0 deletions(-)
Documentation/media/media_api_files/typical_media_device.pdf binary +0 -0
Signature · 1 line
2.7.4
PATCH 2/20 docs-rst: add tabularcolumns to all tables
In reply to Mauro Carvalho ChehabLaTeX doesn't handle too well auto-width on tables, and ReST markup requires an special tag to give it the needed hints.
As we're using A4 paper, we have 17cm of useful spaces. As most media tables have widths, let's use it to generate the needed via the following perl script:
my ($line_size, $table_header, $has_cols) = (17.5, 0, 0); my $out;
my $header = "";
my @widths = ();
sub round { $_[0] > 0 ? int($_[0] + .5) : -int(-$_[0] + .5) }
while (<>) {
if (!$table_header) {
$has_cols = 1 if (m/..\s+tabularcolumns::/);
if (m/..\s+flat-table::/) {
$table_header = 1;
$header = $_;
next;
}
$out .= $_;
next;
}
$header .= $_;
@widths = split(/ /, $1) if (m/:widths:\s+(.*)/);
if (m/^\n$/) {
if (!$has_cols && @widths) {
my ($tot, $t, $i) = (0, 0, 0);
foreach my $v(@widths) { $tot += $v; };
$out .= ".. tabularcolumns:: |";
for ($i = 0; $i < scalar @widths - 1; $i++) {
my $v = $widths[$i];
my $w = round(10 * ($v * $line_size) / $tot) / 10;
$out .= sprintf "p{%.1fcm}|", $w;
$t += $w;
}
my $w = $line_size - $t;
$out .= sprintf "p{%.1fcm}|\n\n", $w;
}
$out .= $header;
$table_header = 0;
$has_cols = 0;
$header = "";
@widths = ();
}
}print $out;
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst | 4 ++++ .../media/uapi/cec/cec-ioc-adap-g-log-addrs.rst | 10 ++++++++++ Documentation/media/uapi/cec/cec-ioc-dqevent.rst | 10 ++++++++++ Documentation/media/uapi/cec/cec-ioc-g-mode.rst | 6 ++++++ Documentation/media/uapi/cec/cec-ioc-receive.rst | 6 ++++++ .../media/uapi/dvb/fe-diseqc-recv-slave-reply.rst | 2 ++ .../media/uapi/dvb/fe-diseqc-send-master-cmd.rst | 2 ++ Documentation/media/uapi/dvb/fe-get-info.rst | 2 ++ Documentation/media/uapi/dvb/fe-type-t.rst | 2 ++ Documentation/media/uapi/gen-errors.rst | 2 ++ .../media/uapi/mediactl/media-ioc-device-info.rst | 2 ++ .../media/uapi/mediactl/media-ioc-enum-entities.rst | 2 ++ .../media/uapi/mediactl/media-ioc-enum-links.rst | 6 ++++++ .../media/uapi/mediactl/media-ioc-g-topology.rst | 12 ++++++++++++ Documentation/media/uapi/rc/rc-tables.rst | 2 ++ Documentation/media/uapi/v4l/buffer.rst | 16 ++++++++++++++++ Documentation/media/uapi/v4l/dev-raw-vbi.rst | 4 ++++ Documentation/media/uapi/v4l/dev-rds.rst | 6 ++++++ Documentation/media/uapi/v4l/dev-sdr.rst | 2 ++ Documentation/media/uapi/v4l/dev-sliced-vbi.rst | 18 ++++++++++++++++++ Documentation/media/uapi/v4l/field-order.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-002.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-003.rst | 4 ++++ Documentation/media/uapi/v4l/pixfmt-007.rst | 18 ++++++++++++++++++ Documentation/media/uapi/v4l/pixfmt-013.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-grey.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-m420.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-nv12.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-nv12m.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-nv16.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-nv16m.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-nv24.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-reserved.rst | 4 ++++ Documentation/media/uapi/v4l/pixfmt-sbggr16.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sbggr8.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-srggb10.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-srggb10p.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-srggb12.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-srggb8.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-uv8.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-uyvy.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-vyuy.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y10.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y10b.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y12.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y12i.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y16-be.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y16.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y41p.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-y8i.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv410.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv411p.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv420.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv420m.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv422m.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv422p.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuv444m.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yuyv.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-yvyu.rst | 2 ++ Documentation/media/uapi/v4l/pixfmt-z16.rst | 2 ++ Documentation/media/uapi/v4l/subdev-formats.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-create-bufs.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-cropcap.rst | 4 ++++ .../media/uapi/v4l/vidioc-dbg-g-chip-info.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-dqevent.rst | 18 ++++++++++++++++++ Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst | 6 ++++++ .../media/uapi/v4l/vidioc-enum-dv-timings.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-enum-fmt.rst | 4 ++++ .../media/uapi/v4l/vidioc-enum-frameintervals.rst | 4 ++++ .../media/uapi/v4l/vidioc-enum-framesizes.rst | 6 ++++++ .../media/uapi/v4l/vidioc-enum-freq-bands.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-enuminput.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-enumoutput.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-enumstd.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-expbuf.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-audio.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-g-audioout.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-crop.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-ctrl.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-g-edid.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-enc-index.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-g-fbuf.rst | 6 ++++++ Documentation/media/uapi/v4l/vidioc-g-frequency.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-g-modulator.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-g-parm.rst | 10 ++++++++++ Documentation/media/uapi/v4l/vidioc-g-priority.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-g-selection.rst | 2 ++ .../media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst | 4 ++++ Documentation/media/uapi/v4l/vidioc-g-tuner.rst | 8 ++++++++ Documentation/media/uapi/v4l/vidioc-queryctrl.rst | 10 ++++++++++ Documentation/media/uapi/v4l/vidioc-reqbufs.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst | 2 ++ .../uapi/v4l/vidioc-subdev-enum-frame-interval.rst | 2 ++ .../media/uapi/v4l/vidioc-subdev-enum-frame-size.rst | 2 ++ .../media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst | 2 ++ Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst | 4 ++++ .../media/uapi/v4l/vidioc-subdev-g-frame-interval.rst | 2 ++ .../media/uapi/v4l/vidioc-subdev-g-selection.rst | 2 ++ .../media/uapi/v4l/vidioc-subscribe-event.rst | 4 ++++ 114 files changed, 430 insertions(+)
Documentation/media/uapi/cec/cec-ioc-adap-g-caps.rst +4 -0
@@ -44,6 +44,8 @@ returns the information to the application. The ioctl never fails. .. _cec-caps: +.. tabularcolumns:: |p{1.0cm}|p{1.0cm}|p{15.5cm}| + .. flat-table:: struct cec_caps :header-rows: 0 :stub-columns: 0
@@ -89,6 +91,8 @@ returns the information to the application. The ioctl never fails. .. _cec-capabilities: +.. tabularcolumns:: |p{4.4cm}|p{1.5cm}|p{11.6cm}| + .. flat-table:: CEC Capabilities Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/cec/cec-ioc-adap-g-log-addrs.rst +10 -0
@@ -69,6 +69,8 @@ logical address types are already defined will return with error ``EBUSY``. .. _cec-log-addrs: +.. tabularcolumns:: |p{1.0cm}|p{1.0cm}|p{15.5cm}| + .. flat-table:: struct cec_log_addrs :header-rows: 0 :stub-columns: 0
@@ -205,6 +207,8 @@ logical address types are already defined will return with error ``EBUSY``. .. _cec-versions: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: CEC Versions :header-rows: 0 :stub-columns: 0
@@ -239,6 +243,8 @@ logical address types are already defined will return with error ``EBUSY``. .. _cec-prim-dev-types: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: CEC Primary Device Types :header-rows: 0 :stub-columns: 0
@@ -305,6 +311,8 @@ logical address types are already defined will return with error ``EBUSY``. .. _cec-log-addr-types: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: CEC Logical Address Types :header-rows: 0 :stub-columns: 0
@@ -373,6 +381,8 @@ logical address types are already defined will return with error ``EBUSY``. .. _cec-all-dev-types-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: CEC All Device Types Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/cec/cec-ioc-dqevent.rst +10 -0
@@ -54,6 +54,8 @@ it is guaranteed that the state did change in between the two events. .. _cec-event-state-change_s: +.. tabularcolumns:: |p{1.8cm}|p{1.8cm}|p{13.9cm}| + .. flat-table:: struct cec_event_state_change :header-rows: 0 :stub-columns: 0
@@ -80,6 +82,8 @@ it is guaranteed that the state did change in between the two events. .. _cec-event-lost-msgs_s: +.. tabularcolumns:: |p{1.0cm}|p{1.0cm}|p{15.5cm}| + .. flat-table:: struct cec_event_lost_msgs :header-rows: 0 :stub-columns: 0
@@ -106,6 +110,8 @@ it is guaranteed that the state did change in between the two events. .. _cec-event: +.. tabularcolumns:: |p{1.6cm}|p{1.6cm}|p{1.6cm}|p{12.7cm}| + .. flat-table:: struct cec_event :header-rows: 0 :stub-columns: 0
@@ -177,6 +183,8 @@ it is guaranteed that the state did change in between the two events. .. _cec-events: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: CEC Events Types :header-rows: 0 :stub-columns: 0
@@ -206,6 +214,8 @@ it is guaranteed that the state did change in between the two events. .. _cec-event-flags: +.. tabularcolumns:: |p{4.4cm}|p{1.5cm}|p{11.6cm}| + .. flat-table:: CEC Event Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/cec/cec-ioc-g-mode.rst +6 -0
@@ -76,6 +76,8 @@ Available initiator modes are: .. _cec-mode-initiator_e: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: Initiator Modes :header-rows: 0 :stub-columns: 0
@@ -119,6 +121,8 @@ Available follower modes are: .. _cec-mode-follower_e: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: Follower Modes :header-rows: 0 :stub-columns: 0
@@ -211,6 +215,8 @@ Core message processing details: .. _cec-core-processing: +.. tabularcolumns:: |p{1.9cm}|p{15.6cm}| + .. flat-table:: Core Message Processing :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/cec/cec-ioc-receive.rst +6 -0
@@ -75,6 +75,8 @@ result. .. _cec-msg: +.. tabularcolumns:: |p{1.0cm}|p{1.0cm}|p{15.5cm}| + .. flat-table:: struct cec_msg :header-rows: 0 :stub-columns: 0
@@ -252,6 +254,8 @@ result. .. _cec-tx-status: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: CEC Transmit Status :header-rows: 0 :stub-columns: 0
@@ -320,6 +324,8 @@ result. .. _cec-rx-status: +.. tabularcolumns:: |p{2.6cm}|p{0.9cm}|p{14.0cm}| + .. flat-table:: CEC Receive Status :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/dvb/fe-diseqc-recv-slave-reply.rst +2 -0
@@ -42,6 +42,8 @@ Receives reply from a DiSEqC 2.0 command. struct dvb_diseqc_slave_reply ----------------------------- +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct dvb_diseqc_slave_reply :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/dvb/fe-diseqc-send-master-cmd.rst +2 -0
@@ -42,6 +42,8 @@ Sends a DiSEqC command to the antenna subsystem. struct dvb_diseqc_master_cmd ============================ +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct dvb_diseqc_master_cmd :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/dvb/fe-get-info.rst +2 -0
@@ -47,6 +47,8 @@ returns an error. struct dvb_frontend_info ======================== +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct dvb_frontend_info :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/dvb/fe-type-t.rst +2 -0
@@ -13,6 +13,8 @@ fe_type_t type, defined as: .. _fe-type: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Frontend types :header-rows: 1 :stub-columns: 0
Documentation/media/uapi/gen-errors.rst +2 -0
@@ -9,6 +9,8 @@ Generic Error Codes .. _gen-errors: +.. tabularcolumns:: |p{1.0cm}|p{16.5cm}| + .. flat-table:: Generic error codes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/mediactl/media-ioc-device-info.rst +2 -0
@@ -42,6 +42,8 @@ ioctl never fails. .. _media-device-info: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct media_device_info :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/mediactl/media-ioc-enum-entities.rst +2 -0
@@ -53,6 +53,8 @@ id's until they get an error. .. _media-entity-desc: +.. tabularcolumns:: |p{1.5cm}|p{1.5cm}|p{1.5cm}|p{1.5cm}|p{11.5cm}| + .. flat-table:: struct media_entity_desc :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/mediactl/media-ioc-enum-links.rst +6 -0
@@ -57,6 +57,8 @@ returned during the enumeration process. .. _media-links-enum: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct media_links_enum :header-rows: 0 :stub-columns: 0
@@ -93,6 +95,8 @@ returned during the enumeration process. .. _media-pad-desc: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct media_pad_desc :header-rows: 0 :stub-columns: 0
@@ -127,6 +131,8 @@ returned during the enumeration process. .. _media-link-desc: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct media_link_desc :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/mediactl/media-ioc-g-topology.rst +12 -0
@@ -51,6 +51,8 @@ desired arrays with the media graph elements. .. _media-v2-topology: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_topology :header-rows: 0 :stub-columns: 0
@@ -145,6 +147,8 @@ desired arrays with the media graph elements. .. _media-v2-entity: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_entity :header-rows: 0 :stub-columns: 0
@@ -188,6 +192,8 @@ desired arrays with the media graph elements. .. _media-v2-interface: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_interface :header-rows: 0 :stub-columns: 0
@@ -239,6 +245,8 @@ desired arrays with the media graph elements. .. _media-v2-intf-devnode: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_interface :header-rows: 0 :stub-columns: 0
@@ -265,6 +273,8 @@ desired arrays with the media graph elements. .. _media-v2-pad: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_pad :header-rows: 0 :stub-columns: 0
@@ -308,6 +318,8 @@ desired arrays with the media graph elements. .. _media-v2-link: +.. tabularcolumns:: |p{1.6cm}|p{3.2cm}|p{12.7cm}| + .. flat-table:: struct media_v2_pad :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/rc/rc-tables.rst +2 -0
@@ -25,6 +25,8 @@ the remote via /dev/input/event devices. .. _rc_standard_keymap: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: IR default keymapping :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/buffer.rst +16 -0
@@ -39,6 +39,8 @@ buffer. struct v4l2_buffer ================== +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_buffer :header-rows: 0 :stub-columns: 0
@@ -282,6 +284,8 @@ struct v4l2_buffer struct v4l2_plane ================= +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -399,6 +403,8 @@ struct v4l2_plane enum v4l2_buf_type ================== +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -513,6 +519,8 @@ enum v4l2_buf_type Buffer Flags ============ +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -762,6 +770,8 @@ Buffer Flags enum v4l2_memory ================ +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -816,6 +826,8 @@ The :ref:`struct v4l2_timecode <v4l2-timecode>` structure is designed to hold a struct v4l2_timecode -------------------- +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -886,6 +898,8 @@ struct v4l2_timecode Timecode Types -------------- +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -939,6 +953,8 @@ Timecode Types Timecode Flags -------------- +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/dev-raw-vbi.rst +4 -0
@@ -102,6 +102,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does .. _v4l2-vbi-format: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_vbi_format :header-rows: 0 :stub-columns: 0
@@ -227,6 +229,8 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does .. _vbifmt-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Raw VBI Format Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/dev-rds.rst +6 -0
@@ -95,6 +95,8 @@ RDS datastructures .. _v4l2-rds-data: +.. tabularcolumns:: |p{2.5cm}|p{2.5cm}|p{12.5cm}| + .. flat-table:: struct v4l2_rds_data :header-rows: 0 :stub-columns: 0
@@ -129,6 +131,8 @@ RDS datastructures .. _v4l2-rds-block: +.. tabularcolumns:: |p{2.9cm}|p{14.6cm}| + .. flat-table:: Block description :header-rows: 0 :stub-columns: 0
@@ -166,6 +170,8 @@ RDS datastructures .. _v4l2-rds-block-codes: +.. tabularcolumns:: |p{2.2cm}|p{2.2cm}|p{2.2cm}|p{10.9cm}| + .. flat-table:: Block defines :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/dev-sdr.rst +2 -0
@@ -80,6 +80,8 @@ data transfer, set by the driver in order to inform application. .. _v4l2-sdr-format: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_sdr_format :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/dev-sliced-vbi.rst +18 -0
@@ -105,6 +105,8 @@ which may return ``EBUSY`` can be the struct v4l2_sliced_vbi_format ----------------------------- +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -250,6 +252,8 @@ struct v4l2_sliced_vbi_format Sliced VBI services ------------------- +.. tabularcolumns:: |p{4.4cm}|p{2.2cm}|p{2.2cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: :header-rows: 1 :stub-columns: 0
@@ -371,6 +375,8 @@ of one video frame. The ``id`` of unused struct v4l2_sliced_vbi_data --------------------------- +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -556,6 +562,8 @@ number). struct v4l2_mpeg_vbi_fmt_ivtv ----------------------------- +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -611,6 +619,8 @@ struct v4l2_mpeg_vbi_fmt_ivtv Magic Constants for struct v4l2_mpeg_vbi_fmt_ivtv magic field ------------------------------------------------------------- +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 1 :stub-columns: 0
@@ -652,6 +662,8 @@ Magic Constants for struct v4l2_mpeg_vbi_fmt_ivtv magic field struct v4l2_mpeg_vbi_itv0 ------------------------- +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -709,6 +721,8 @@ struct v4l2_mpeg_vbi_itv0 struct v4l2_mpeg_vbi_ITV0 ------------------------- +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -734,6 +748,8 @@ struct v4l2_mpeg_vbi_ITV0 struct v4l2_mpeg_vbi_itv0_line ------------------------------ +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -765,6 +781,8 @@ struct v4l2_mpeg_vbi_itv0_line Line Identifiers for struct v4l2_mpeg_vbi_itv0_line id field ------------------------------------------------------------ +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 1 :stub-columns: 0
Documentation/media/uapi/v4l/field-order.rst +2 -0
@@ -57,6 +57,8 @@ should have the value ``V4L2_FIELD_ANY`` (0). enum v4l2_field =============== +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-002.rst +2 -0
@@ -7,6 +7,8 @@ Single-planar format structure .. _v4l2-pix-format: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_pix_format :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-003.rst +4 -0
@@ -14,6 +14,8 @@ describing all planes of that format. .. _v4l2-plane-pix-format: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_plane_pix_format :header-rows: 0 :stub-columns: 0
@@ -50,6 +52,8 @@ describing all planes of that format. .. _v4l2-pix-format-mplane: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_pix_format_mplane :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-007.rst +18 -0
@@ -19,6 +19,8 @@ are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: SMPTE 170M Chromaticities :header-rows: 1 :stub-columns: 0
@@ -123,6 +125,8 @@ and the white reference are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: Rec. 709 Chromaticities :header-rows: 1 :stub-columns: 0
@@ -262,6 +266,8 @@ The chromaticities of the primary colors and the white reference are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: sRGB Chromaticities :header-rows: 1 :stub-columns: 0
@@ -367,6 +373,8 @@ are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: Adobe RGB Chromaticities :header-rows: 1 :stub-columns: 0
@@ -457,6 +465,8 @@ of the primary colors and the white reference are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: BT.2020 Chromaticities :header-rows: 1 :stub-columns: 0
@@ -579,6 +589,8 @@ is ``V4L2_XFER_FUNC_DCI_P3``. The default Y'CbCr encoding is +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: DCI-P3 Chromaticities :header-rows: 1 :stub-columns: 0
@@ -656,6 +668,8 @@ and the white reference are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: SMPTE 240M Chromaticities :header-rows: 1 :stub-columns: 0
@@ -750,6 +764,8 @@ reference are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: NTSC 1953 Chromaticities :header-rows: 1 :stub-columns: 0
@@ -852,6 +868,8 @@ are: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: EBU Tech. 3213 Chromaticities :header-rows: 1 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-013.rst +2 -0
@@ -7,6 +7,8 @@ Compressed Formats .. _compressed-formats: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Compressed Image Formats :header-rows: 1 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-grey.rst +2 -0
@@ -22,6 +22,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-m420.rst +2 -0
@@ -33,6 +33,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-nv12.rst +2 -0
@@ -37,6 +37,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-nv12m.rst +2 -0
@@ -47,6 +47,8 @@ many pad bytes after its rows. **Byte Order.** Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-nv16.rst +2 -0
@@ -36,6 +36,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-nv16m.rst +2 -0
@@ -39,6 +39,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-nv24.rst +2 -0
@@ -36,6 +36,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst +2 -0
@@ -981,6 +981,8 @@ Each cell is one byte. +.. 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}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-reserved.rst +4 -0
@@ -19,6 +19,8 @@ please make a proposal on the linux-media mailing list. .. _reserved-formats: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Reserved Image Formats :header-rows: 1 :stub-columns: 0
@@ -341,6 +343,8 @@ please make a proposal on the linux-media mailing list. .. _format-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Format Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sbggr16.rst +2 -0
@@ -29,6 +29,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sbggr8.rst +2 -0
@@ -26,6 +26,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst +2 -0
@@ -24,6 +24,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{11.7cm}|p{5.8cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst +2 -0
@@ -25,6 +25,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst +2 -0
@@ -24,6 +24,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{11.7cm}|p{5.8cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst +2 -0
@@ -24,6 +24,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst +2 -0
@@ -23,6 +23,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst +2 -0
@@ -26,6 +26,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst +2 -0
@@ -26,6 +26,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-srggb10.rst +2 -0
@@ -33,6 +33,8 @@ Each cell is one byte, high 6 bits in high bytes are 0. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-srggb10p.rst +2 -0
@@ -36,6 +36,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.0cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-srggb12.rst +2 -0
@@ -34,6 +34,8 @@ Each cell is one byte, high 6 bits in high bytes are 0. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-srggb8.rst +2 -0
@@ -26,6 +26,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-uv8.rst +2 -0
@@ -21,6 +21,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-uyvy.rst +2 -0
@@ -23,6 +23,8 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-vyuy.rst +2 -0
@@ -23,6 +23,8 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y10.rst +2 -0
@@ -23,6 +23,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y10b.rst +2 -0
@@ -26,6 +26,8 @@ pixels. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y12.rst +2 -0
@@ -23,6 +23,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y12i.rst +2 -0
@@ -29,6 +29,8 @@ these pixels can be deinterlaced using pixels cross the byte boundary and have a ratio of 3 bytes for each interleaved pixel. +.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y16-be.rst +2 -0
@@ -27,6 +27,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y16.rst +2 -0
@@ -27,6 +27,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y41p.rst +2 -0
@@ -30,6 +30,8 @@ Each cell is one byte. +.. 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}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-y8i.rst +2 -0
@@ -24,6 +24,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv410.rst +2 -0
@@ -37,6 +37,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv411p.rst +2 -0
@@ -33,6 +33,8 @@ have ¼ as many pad bytes after their rows. In other words, four C x rows Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv420.rst +2 -0
@@ -38,6 +38,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv420m.rst +2 -0
@@ -45,6 +45,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv422m.rst +2 -0
@@ -44,6 +44,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv422p.rst +2 -0
@@ -34,6 +34,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuv444m.rst +2 -0
@@ -38,6 +38,8 @@ described in :ref:`planar-apis`. **Byte Order.** Each cell is one byte. +.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yuyv.rst +2 -0
@@ -26,6 +26,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-yvyu.rst +2 -0
@@ -23,6 +23,8 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/pixfmt-z16.rst +2 -0
@@ -24,6 +24,8 @@ Each cell is one byte. +.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/subdev-formats.rst +2 -0
@@ -8,6 +8,8 @@ Media Bus Formats .. _v4l2-mbus-framefmt: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_mbus_framefmt :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-create-bufs.rst +2 -0
@@ -75,6 +75,8 @@ than the number requested. .. _v4l2-create-buffers: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_create_buffers :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-cropcap.rst +4 -0
@@ -54,6 +54,8 @@ overlay devices. .. _v4l2-cropcap: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_cropcap :header-rows: 0 :stub-columns: 0
@@ -114,6 +116,8 @@ overlay devices. .. _v4l2-rect-crop: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_rect :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-dbg-g-chip-info.rst +6 -0
@@ -80,6 +80,8 @@ instructions. .. _name-v4l2-dbg-match: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_dbg_match :header-rows: 0 :stub-columns: 0
@@ -124,6 +126,8 @@ instructions. .. _v4l2-dbg-chip-info: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_dbg_chip_info :header-rows: 0 :stub-columns: 0
@@ -169,6 +173,8 @@ instructions. .. _name-chip-match-types: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Chip Match Types :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-dbg-g-register.rst +4 -0
@@ -88,6 +88,8 @@ instructions. .. _v4l2-dbg-match: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_dbg_match :header-rows: 0 :stub-columns: 0
@@ -173,6 +175,8 @@ instructions. .. _chip-match-types: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Chip Match Types :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-decoder-cmd.rst +4 -0
@@ -58,6 +58,8 @@ introduced in Linux 3.3. .. _v4l2-decoder-cmd: +.. tabularcolumns:: |p{2.9cm}|p{2.9cm}|p{5.8cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: struct v4l2_decoder_cmd :header-rows: 0 :stub-columns: 0
@@ -187,6 +189,8 @@ introduced in Linux 3.3. .. _decoder-cmds: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Decoder Commands :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-dqevent.rst +18 -0
@@ -42,6 +42,8 @@ call. .. _v4l2-event: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_event :header-rows: 0 :stub-columns: 0
@@ -177,6 +179,8 @@ call. .. _event-type: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Event Types :header-rows: 0 :stub-columns: 0
@@ -304,6 +308,8 @@ call. .. _v4l2-event-vsync: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_event_vsync :header-rows: 0 :stub-columns: 0
@@ -322,6 +328,8 @@ call. .. _v4l2-event-ctrl: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_event_ctrl :header-rows: 0 :stub-columns: 0
@@ -429,6 +437,8 @@ call. .. _v4l2-event-frame-sync: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_event_frame_sync :header-rows: 0 :stub-columns: 0
@@ -447,6 +457,8 @@ call. .. _v4l2-event-src-change: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_event_src_change :header-rows: 0 :stub-columns: 0
@@ -466,6 +478,8 @@ call. .. _v4l2-event-motion-det: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_event_motion_det :header-rows: 0 :stub-columns: 0
@@ -509,6 +523,8 @@ call. .. _ctrl-changes-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Control Changes :header-rows: 0 :stub-columns: 0
@@ -548,6 +564,8 @@ call. .. _src-changes-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Source Changes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-dv-timings-cap.rst +4 -0
@@ -56,6 +56,8 @@ that doesn't support them will return an ``EINVAL`` error code. .. _v4l2-bt-timings-cap: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_bt_timings_cap :header-rows: 0 :stub-columns: 0
@@ -141,6 +143,8 @@ that doesn't support them will return an ``EINVAL`` error code. .. _v4l2-dv-timings-cap: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_dv_timings_cap :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-encoder-cmd.rst +6 -0
@@ -66,6 +66,8 @@ introduced in Linux 2.6.21. .. _v4l2-encoder-cmd: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_encoder_cmd :header-rows: 0 :stub-columns: 0
@@ -103,6 +105,8 @@ introduced in Linux 2.6.21. .. _encoder-cmds: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Encoder Commands :header-rows: 0 :stub-columns: 0
@@ -164,6 +168,8 @@ introduced in Linux 2.6.21. .. _encoder-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Encoder Command Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enum-dv-timings.rst +2 -0
@@ -66,6 +66,8 @@ return an ``EINVAL`` error code. .. _v4l2-enum-dv-timings: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_enum_dv_timings :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enum-fmt.rst +4 -0
@@ -48,6 +48,8 @@ one until ``EINVAL`` is returned. .. _v4l2-fmtdesc: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_fmtdesc :header-rows: 0 :stub-columns: 0
@@ -129,6 +131,8 @@ one until ``EINVAL`` is returned. .. _fmtdesc-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Image Format Description Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enum-frameintervals.rst +4 -0
@@ -105,6 +105,8 @@ application should zero out all members except for the *IN* fields. .. _v4l2-frmival-stepwise: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_frmival_stepwise :header-rows: 0 :stub-columns: 0
@@ -233,6 +235,8 @@ Enums .. _v4l2-frmivaltypes: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: enum v4l2_frmivaltypes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enum-framesizes.rst +6 -0
@@ -94,6 +94,8 @@ application should zero out all members except for the *IN* fields. .. _v4l2-frmsize-discrete: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_frmsize_discrete :header-rows: 0 :stub-columns: 0
@@ -120,6 +122,8 @@ application should zero out all members except for the *IN* fields. .. _v4l2-frmsize-stepwise: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_frmsize_stepwise :header-rows: 0 :stub-columns: 0
@@ -254,6 +258,8 @@ Enums .. _v4l2-frmsizetypes: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: enum v4l2_frmsizetypes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enum-freq-bands.rst +4 -0
@@ -45,6 +45,8 @@ of the corresponding tuner/modulator is set. .. _v4l2-frequency-band: +.. tabularcolumns:: |p{2.9cm}|p{2.9cm}|p{5.8cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: struct v4l2_frequency_band :header-rows: 0 :stub-columns: 0
@@ -151,6 +153,8 @@ of the corresponding tuner/modulator is set. .. _band-modulation: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Band Modulation Systems :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enuminput.rst +6 -0
@@ -43,6 +43,8 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. .. _v4l2-input: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_input :header-rows: 0 :stub-columns: 0
@@ -150,6 +152,8 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. .. _input-type: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Input Types :header-rows: 0 :stub-columns: 0
@@ -320,6 +324,8 @@ at index zero, incrementing by one until the driver returns ``EINVAL``. .. _input-capabilities: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Input capabilities :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enumoutput.rst +6 -0
@@ -44,6 +44,8 @@ EINVAL. .. _v4l2-output: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_output :header-rows: 0 :stub-columns: 0
@@ -140,6 +142,8 @@ EINVAL. .. _output-type: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Output Type :header-rows: 0 :stub-columns: 0
@@ -175,6 +179,8 @@ EINVAL. .. _output-capabilities: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Output capabilities :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-enumstd.rst +6 -0
@@ -46,6 +46,8 @@ or output. [#f1]_ .. _v4l2-standard: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_standard :header-rows: 0 :stub-columns: 0
@@ -114,6 +116,8 @@ or output. [#f1]_ .. _v4l2-fract: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_fract :header-rows: 0 :stub-columns: 0
@@ -140,6 +144,8 @@ or output. [#f1]_ .. _v4l2-std-id: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: typedef v4l2_std_id :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-expbuf.rst +2 -0
@@ -118,6 +118,8 @@ Examples .. _v4l2-exportbuffer: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_exportbuffer :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-audio.rst +6 -0
@@ -52,6 +52,8 @@ return the actual new audio mode. .. _v4l2-audio: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_audio :header-rows: 0 :stub-columns: 0
@@ -106,6 +108,8 @@ return the actual new audio mode. .. _audio-capability: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Audio Capability Flags :header-rows: 0 :stub-columns: 0
@@ -135,6 +139,8 @@ return the actual new audio mode. .. _audio-mode: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Audio Mode Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-audioout.rst +2 -0
@@ -59,6 +59,8 @@ as ``VIDIOC_G_AUDOUT`` does. .. _v4l2-audioout: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_audioout :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-crop.rst +2 -0
@@ -78,6 +78,8 @@ When cropping is not supported then no parameters are changed and .. _v4l2-crop: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_crop :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-ctrl.rst +2 -0
@@ -56,6 +56,8 @@ These ioctls work only with user controls. For other control classes the .. _v4l2-control: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_control :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-dv-timings.rst +6 -0
@@ -70,6 +70,8 @@ EBUSY .. _v4l2-bt-timings: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_bt_timings :header-rows: 0 :stub-columns: 0
@@ -223,6 +225,8 @@ EBUSY .. _v4l2-dv-timings: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_dv_timings :header-rows: 0 :stub-columns: 0
@@ -267,6 +271,8 @@ EBUSY .. _dv-timing-types: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: DV Timing types :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-edid.rst +2 -0
@@ -92,6 +92,8 @@ EDID is no longer available. .. _v4l2-edid: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_edid :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-enc-index.rst +6 -0
@@ -59,6 +59,8 @@ video elementary streams. .. _v4l2-enc-idx: +.. tabularcolumns:: |p{2.9cm}|p{2.9cm}|p{5.8cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: struct v4l2_enc_idx :header-rows: 0 :stub-columns: 0
@@ -105,6 +107,8 @@ video elementary streams. .. _v4l2-enc-idx-entry: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_enc_idx_entry :header-rows: 0 :stub-columns: 0
@@ -162,6 +166,8 @@ video elementary streams. .. _enc-idx-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Index Entry Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-ext-ctrls.rst +6 -0
@@ -97,6 +97,8 @@ still cause this situation. .. _v4l2-ext-control: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_ext_control :header-rows: 0 :stub-columns: 0
@@ -228,6 +230,8 @@ still cause this situation. .. _v4l2-ext-controls: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_ext_controls :header-rows: 0 :stub-columns: 0
@@ -360,6 +364,8 @@ still cause this situation. .. _ctrl-class: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Control classes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-fbuf.rst +6 -0
@@ -78,6 +78,8 @@ destructive video overlay. .. _v4l2-framebuffer: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_framebuffer :header-rows: 0 :stub-columns: 0
@@ -283,6 +285,8 @@ destructive video overlay. .. _framebuffer-cap: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Frame Buffer Capability Flags :header-rows: 0 :stub-columns: 0
@@ -371,6 +375,8 @@ destructive video overlay. .. _framebuffer-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Frame Buffer Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-frequency.rst +2 -0
@@ -54,6 +54,8 @@ write-only ioctl, it does not return the actual new frequency. .. _v4l2-frequency: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_frequency :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-jpegcomp.rst +4 -0
@@ -57,6 +57,8 @@ encoding. You usually do want to add them. .. _v4l2-jpegcompression: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_jpegcompression :header-rows: 0 :stub-columns: 0
@@ -129,6 +131,8 @@ encoding. You usually do want to add them. .. _jpeg-markers: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: JPEG Markers Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-modulator.rst +4 -0
@@ -63,6 +63,8 @@ To change the radio frequency the .. _v4l2-modulator: +.. tabularcolumns:: |p{2.9cm}|p{2.9cm}|p{5.8cm}|p{2.9cm}|p{3.0cm}| + .. flat-table:: struct v4l2_modulator :header-rows: 0 :stub-columns: 0
@@ -160,6 +162,8 @@ To change the radio frequency the .. _modulator-txsubchans: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Modulator Audio Transmission Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-parm.rst +10 -0
@@ -52,6 +52,8 @@ union holding separate parameters for input and output devices. .. _v4l2-streamparm: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| + .. flat-table:: struct v4l2_streamparm :header-rows: 0 :stub-columns: 0
@@ -111,6 +113,8 @@ union holding separate parameters for input and output devices. .. _v4l2-captureparm: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_captureparm :header-rows: 0 :stub-columns: 0
@@ -192,6 +196,8 @@ union holding separate parameters for input and output devices. .. _v4l2-outputparm: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_outputparm :header-rows: 0 :stub-columns: 0
@@ -280,6 +286,8 @@ union holding separate parameters for input and output devices. .. _parm-caps: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Streaming Parameters Capabilites :header-rows: 0 :stub-columns: 0
@@ -299,6 +307,8 @@ union holding separate parameters for input and output devices. .. _parm-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Capture Parameters Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-priority.rst +2 -0
@@ -47,6 +47,8 @@ with a pointer to this variable. .. _v4l2-priority: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: enum v4l2_priority :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-selection.rst +2 -0
@@ -137,6 +137,8 @@ Selection targets and flags are documented in .. _v4l2-selection: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_selection :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-sliced-vbi-cap.rst +4 -0
@@ -48,6 +48,8 @@ the sliced VBI API is unsupported or ``type`` is invalid. .. _v4l2-sliced-vbi-cap: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}| + .. flat-table:: struct v4l2_sliced_vbi_cap :header-rows: 0 :stub-columns: 0
@@ -175,6 +177,8 @@ the sliced VBI API is unsupported or ``type`` is invalid. .. _vbi-services: +.. tabularcolumns:: |p{4.4cm}|p{2.2cm}|p{2.2cm}|p{4.4cm}|p{4.3cm}| + .. flat-table:: Sliced VBI services :header-rows: 1 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-g-tuner.rst +8 -0
@@ -255,6 +255,8 @@ To change the radio frequency the .. _v4l2-tuner-type: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: enum v4l2_tuner_type :header-rows: 0 :stub-columns: 0
@@ -297,6 +299,8 @@ To change the radio frequency the .. _tuner-capability: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Tuner and Modulator Capability Flags :header-rows: 0 :stub-columns: 0
@@ -455,6 +459,8 @@ To change the radio frequency the .. _tuner-rxsubchans: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Tuner Audio Reception Flags :header-rows: 0 :stub-columns: 0
@@ -522,6 +528,8 @@ To change the radio frequency the .. _tuner-audmode: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Tuner Audio Modes :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-queryctrl.rst +10 -0
@@ -96,6 +96,8 @@ See also the examples in :ref:`control`. .. _v4l2-queryctrl: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_queryctrl :header-rows: 0 :stub-columns: 0
@@ -216,6 +218,8 @@ See also the examples in :ref:`control`. .. _v4l2-query-ext-ctrl: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_query_ext_ctrl :header-rows: 0 :stub-columns: 0
@@ -378,6 +382,8 @@ See also the examples in :ref:`control`. .. _v4l2-querymenu: +.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{7.0cm}|p{3.5cm}| + .. flat-table:: struct v4l2_querymenu :header-rows: 0 :stub-columns: 0
@@ -446,6 +452,8 @@ See also the examples in :ref:`control`. .. _v4l2-ctrl-type: +.. tabularcolumns:: |p{5.3cm}|p{0.9cm}|p{0.9cm}|p{0.9cm}|p{9.5cm}| + .. flat-table:: enum v4l2_ctrl_type :header-rows: 1 :stub-columns: 0
@@ -643,6 +651,8 @@ See also the examples in :ref:`control`. .. _control-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Control Flags :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-reqbufs.rst +2 -0
@@ -69,6 +69,8 @@ any DMA in progress, an implicit .. _v4l2-requestbuffers: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_requestbuffers :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-s-hw-freq-seek.rst +2 -0
@@ -63,6 +63,8 @@ error code is returned and no seek takes place. .. _v4l2-hw-freq-seek: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_hw_freq_seek :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-interval.rst +2 -0
@@ -64,6 +64,8 @@ multiple pads of the same sub-device is not defined. .. _v4l2-subdev-frame-interval-enum: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_frame_interval_enum :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-enum-frame-size.rst +2 -0
@@ -66,6 +66,8 @@ information about try formats. .. _v4l2-subdev-frame-size-enum: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_frame_size_enum :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-enum-mbus-code.rst +2 -0
@@ -51,6 +51,8 @@ information about the try formats. .. _v4l2-subdev-mbus-code-enum: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_mbus_code_enum :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-g-crop.rst +2 -0
@@ -74,6 +74,8 @@ modified format should be as close as possible to the original request. .. _v4l2-subdev-crop: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_crop :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-g-fmt.rst +4 -0
@@ -77,6 +77,8 @@ should be as close as possible to the original request. .. _v4l2-subdev-format: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_format :header-rows: 0 :stub-columns: 0
@@ -122,6 +124,8 @@ should be as close as possible to the original request. .. _v4l2-subdev-format-whence: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: enum v4l2_subdev_format_whence :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-g-frame-interval.rst +2 -0
@@ -69,6 +69,8 @@ the same sub-device is not defined. .. _v4l2-subdev-frame-interval: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_frame_interval :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subdev-g-selection.rst +2 -0
@@ -66,6 +66,8 @@ Selection targets and flags are documented in .. _v4l2-subdev-selection: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_subdev_selection :header-rows: 0 :stub-columns: 0
Documentation/media/uapi/v4l/vidioc-subscribe-event.rst +4 -0
@@ -40,6 +40,8 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. .. _v4l2-event-subscription: +.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| + .. flat-table:: struct v4l2_event_subscription :header-rows: 0 :stub-columns: 0
@@ -91,6 +93,8 @@ using the :ref:`VIDIOC_DQEVENT` ioctl. .. _event-flags: +.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| + .. flat-table:: Event Flags :header-rows: 0 :stub-columns: 0
Signature · 1 line
2.7.4
PATCH 3/20 control.rst: Fix table width
In reply to Mauro Carvalho ChehabManually adjust the table width for it to look nice on PDF output.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/control.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
Documentation/media/uapi/v4l/control.rst +3 -1
@@ -191,10 +191,12 @@ Control IDs +.. tabularcolumns:: |p{5.5cm}|p{12cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0 - + :widths: 11 24 - .. row 1
Signature · 1 line
2.7.4
PATCH 4/20 extended-controls.rst: fix table sizes
In reply to Mauro Carvalho ChehabLots of tables at extended-controls.rst need explicit hints for LaTeX to adjust their widths. Provide that.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/extended-controls.rst | 63 ++++++++++++---------- 1 file changed, 36 insertions(+), 27 deletions(-)
Documentation/media/uapi/v4l/extended-controls.rst +36 -27
@@ -291,6 +291,8 @@ Codec Control IDs +.. tabularcolumns:: |p{6 cm}|p{11.5cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -964,6 +966,8 @@ Codec Control IDs +.. tabularcolumns:: |p{9.0cm}|p{8.5cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -1671,6 +1675,8 @@ Codec Control IDs +.. tabularcolumns:: |p{5.5cm}|p{12.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -1715,11 +1721,12 @@ Codec Control IDs +.. tabularcolumns:: |p{14.0cm}|p{3.5cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_MPEG_VIDEO_H264_LOOP_FILTER_MODE_ENABLED``
@@ -1918,6 +1925,8 @@ Codec Control IDs +.. tabularcolumns:: |p{10.3cm}|p{7.2cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -1967,17 +1976,16 @@ Codec Control IDs .. _v4l2-mpeg-video-h264-sei-fp-arrangement-type: -``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE (enum v4l2_mpeg_video_h264_sei_fp_arrangement_type)`` +``V4L2_CID_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE`` ``(enum v4l2_mpeg_video_h264_sei_fp_arrangement_type)`` Frame packing arrangement type for H264 SEI. Applicable to the H264 encoder. Possible values are: - +.. tabularcolumns:: |p{12cm}|p{5.5cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_MPEG_VIDEO_H264_SEI_FP_ARRANGEMENT_TYPE_CHEKERBOARD``
@@ -2023,18 +2031,17 @@ Codec Control IDs .. _v4l2-mpeg-video-h264-fmo-map-type: -``V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE (enum v4l2_mpeg_video_h264_fmo_map_type)`` +``V4L2_CID_MPEG_VIDEO_H264_FMO_MAP_TYPE`` ``(enum v4l2_mpeg_video_h264_fmo_map_type)`` When using FMO, the map type divides the image in different scan patterns of macroblocks. Applicable to the H264 encoder. Possible values are: - +.. tabularcolumns:: |p{12.5cm}|p{5.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_MPEG_VIDEO_H264_FMO_MAP_TYPE_INTERLEAVED_SLICES``
@@ -2330,12 +2337,12 @@ MFC 5.1 Control IDs are: +.. tabularcolumns:: |p{9.0cm}|p{8.5cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_MPEG_MFC51_FRAME_SKIP_MODE_DISABLED``
@@ -2455,6 +2462,8 @@ CX2341x Control IDs +.. tabularcolumns:: |p{14.5cm}|p{3.0cm}| + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -2679,13 +2688,12 @@ VPX Control IDs The number of reference pictures for encoding P frames. Possible values are: - +.. tabularcolumns:: |p{7.9cm}|p{9.6cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_CID_MPEG_VIDEO_VPX_1_REF_FRAME``
@@ -2731,13 +2739,16 @@ VPX Control IDs ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_SEL (enum v4l2_vp8_golden_frame_sel)`` Selects the golden frame for encoding. Possible values are: +.. raw:: latex + \begin{adjustbox}{width=\columnwidth} + +.. tabularcolumns:: |p{11.0cm}|p{10.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_PREV``
@@ -2750,9 +2761,12 @@ VPX Control IDs - ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_USE_REF_PERIOD`` - Use the previous specific frame indicated by - V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD as a + ``V4L2_CID_MPEG_VIDEO_VPX_GOLDEN_FRAME_REF_PERIOD`` as a golden frame. +.. raw:: latex + + \end{adjustbox} ``V4L2_CID_MPEG_VIDEO_VPX_MIN_QP (integer)``
@@ -2862,13 +2876,12 @@ Camera Control IDs Determines how the camera measures the amount of light available for the frame exposure. Possible values are: - +.. tabularcolumns:: |p{8.5cm}|p{9.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_EXPOSURE_METERING_AVERAGE``
@@ -2970,13 +2983,12 @@ Camera Control IDs control may stop updates of the ``V4L2_CID_AUTO_FOCUS_STATUS`` control value. - +.. tabularcolumns:: |p{6.5cm}|p{11.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_AUTO_FOCUS_STATUS_IDLE``
@@ -3009,7 +3021,7 @@ Camera Control IDs ``V4L2_CID_AUTO_FOCUS_RANGE (enum v4l2_auto_focus_range)`` Determines auto focus distance range for which lens may be adjusted. - +.. tabularcolumns:: |p{6.5cm}|p{11.0cm}| .. flat-table:: :header-rows: 0
@@ -3097,13 +3109,12 @@ Camera Control IDs representation. The following white balance presets are listed in order of increasing color temperature. - +.. tabularcolumns:: |p{7.0 cm}|p{10.5cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_WHITE_BALANCE_MANUAL``
@@ -3245,13 +3256,12 @@ Camera Control IDs to ``V4L2_SCENE_MODE_NONE`` to make sure the other possibly related controls are accessible. The following scene programs are defined: - +.. tabularcolumns:: |p{6.0cm}|p{11.5cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_SCENE_MODE_NONE``
@@ -3710,13 +3720,12 @@ Flash Control IDs ``V4L2_CID_FLASH_STROBE_SOURCE (menu)`` Defines the source of the flash LED strobe. - +.. tabularcolumns:: |p{7.0cm}|p{10.5cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - - .. row 1 - ``V4L2_FLASH_STROBE_SOURCE_SOFTWARE``
@@ -3777,7 +3786,7 @@ Flash Control IDs an effect is chip dependent. Reading the faults resets the control and returns the chip to a usable state if possible. - +.. tabularcolumns:: |p{8.0cm}|p{9.5cm}| .. flat-table:: :header-rows: 0
@@ -3888,7 +3897,7 @@ JPEG Control IDs how Cb and Cr components are downsampled after coverting an input image from RGB to Y'CbCr color space. - +.. tabularcolumns:: |p{7.0cm}|p{10.5cm}| .. flat-table:: :header-rows: 0
@@ -4190,7 +4199,7 @@ Digital Video Control IDs or an analog source. The enum v4l2_dv_it_content_type defines the possible content types: - +.. tabularcolumns:: |p{7.0cm}|p{10.5cm}| .. flat-table:: :header-rows: 0
@@ -4384,7 +4393,7 @@ Detect Control IDs ``V4L2_CID_DETECT_MD_MODE (menu)`` Sets the motion detection mode. - +.. tabularcolumns:: |p{7.5cm}|p{10.0cm}| .. flat-table:: :header-rows: 0
Signature · 1 line
2.7.4
PATCH 5/20 docs-rst: add column hints for pixfmt-002 and pixfmt-006
In reply to Mauro Carvalho ChehabAdd column hints for LaTeX to format columns on the tables inside pixfmt-002.rst and pixfmt-006.rst.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/pixfmt-002.rst | 4 +++- Documentation/media/uapi/v4l/pixfmt-006.rst | 5 +++++ 2 files changed, 8 insertions(+), 1 deletion(-)
Documentation/media/uapi/v4l/pixfmt-002.rst +3 -1
@@ -7,7 +7,9 @@ Single-planar format structure .. _v4l2-pix-format: -.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| +.. tabularcolumns:: |p{4.0cm}|p{2.5cm}|p{11.0cm}| + +.. cssclass:: longtable .. flat-table:: struct v4l2_pix_format :header-rows: 0
Documentation/media/uapi/v4l/pixfmt-006.rst +5 -0
@@ -25,6 +25,7 @@ needs to be filled in. colorspaces except for BT.2020 which uses limited range R'G'B' quantization. +.. tabularcolumns:: |p{6.0cm}|p{11.5cm}| .. _v4l2-colorspace:
@@ -183,6 +184,8 @@ needs to be filled in. .. _v4l2-ycbcr-encoding: +.. tabularcolumns:: |p{6.5cm}|p{11.0cm}| + .. flat-table:: V4L2 Y'CbCr Encodings :header-rows: 1 :stub-columns: 0
@@ -252,6 +255,8 @@ needs to be filled in. .. _v4l2-quantization: +.. tabularcolumns:: |p{6.5cm}|p{11.0cm}| + .. flat-table:: V4L2 Quantization Methods :header-rows: 1 :stub-columns: 0
Signature · 1 line
2.7.4
PATCH 6/20 pixfmt-packed-rgb.rst: Fix cell spans
In reply to Mauro Carvalho ChehabThere is an extra column just before eack pack of bits, to improve table reading, but the header file didn't take this into account.
Fix it.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 78 ++++++++++++---------- 1 file changed, 42 insertions(+), 36 deletions(-)
Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst +42 -36
@@ -39,10 +39,13 @@ next to each other in memory. - - :cspan:`7` Byte 0 in memory + - - :cspan:`7` Byte 1 + - - :cspan:`7` Byte 2 + - - :cspan:`7` Byte 3 - .. row 2
@@ -205,13 +208,13 @@ next to each other in memory. - b\ :sub:`0` - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`3`
@@ -285,7 +288,7 @@ next to each other in memory. - b\ :sub:`0` - - - - + - - r\ :sub:`4`
@@ -388,7 +391,7 @@ next to each other in memory. - 'XR15' | (1 << 31) - - - - + - - r\ :sub:`4`
@@ -620,34 +623,34 @@ next to each other in memory. - r\ :sub:`0` - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - .. _V4L2-PIX-FMT-ABGR32:
@@ -781,21 +784,21 @@ next to each other in memory. - r\ :sub:`0` - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - .. _V4L2-PIX-FMT-ARGB32:
@@ -878,21 +881,21 @@ next to each other in memory. - 'BX24' - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - r\ :sub:`7`
@@ -1124,10 +1127,13 @@ either the corresponding ARGB or XRGB format, depending on the driver. - - :cspan:`7` Byte 0 in memory + - - :cspan:`7` Byte 1 + - - :cspan:`7` Byte 2 + - - :cspan:`7` Byte 3 - .. row 2
Signature · 1 line
2.7.4
PATCH 7/20 pixfmt-packed-rgb.rst: adjust tables to fit in LaTeX
In reply to Mauro Carvalho ChehabAdjust the tables to fit at the LaTeX and PDF outputs.
Previously, we were displaying the long table in landscape, but it makes harder to read on displays.
This time, 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 Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst | 37 ++++++++++++++-------- 1 file changed, 24 insertions(+), 13 deletions(-)
Documentation/media/uapi/v4l/pixfmt-packed-rgb.rst +24 -13
@@ -6,11 +6,6 @@ Packed RGB formats ****************** -*man Packed RGB formats(2)* - -Packed RGB formats - - Description ===========
@@ -21,11 +16,12 @@ next to each other in memory. .. raw:: latex - \begin{landscape} - \begin{adjustbox}{width=\columnwidth} + \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
@@ -950,10 +946,9 @@ next to each other in memory. .. raw:: latex - \end{adjustbox} - \end{landscape} + \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
@@ -983,13 +978,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
@@ -1104,6 +1102,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.
@@ -1113,6 +1114,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
@@ -1477,6 +1485,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
Signature · 1 line
2.7.4
PATCH 8/20 pixfmt-packed-yuv.rst: adjust tables to fit in LaTeX
In reply to Mauro Carvalho ChehabAdjust the table to fit at the LaTeX and PDF outputs, just like what was done with pixfmt-packed-rgb.rst.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst | 26 ++++++++++++++-------- 1 file changed, 17 insertions(+), 9 deletions(-)
Documentation/media/uapi/v4l/pixfmt-packed-yuv.rst +17 -9
@@ -6,18 +6,19 @@ Packed YUV formats ****************** -*man Packed YUV formats(2)* - -Packed YUV formats - - Description =========== Similar to the packed RGB formats these formats store the Y, Cb and Cr component of each pixel in one 16 or 32 bit word. +.. 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 YUV Image Formats :header-rows: 2
@@ -309,8 +310,15 @@ component of each pixel in one 16 or 32 bit word. - Cr\ :sub:`0` +.. raw:: latex -Bit 7 is the most significant bit. The value of a = alpha bits is -undefined when reading from the driver, ignored when writing to the -driver, except when alpha blending has been negotiated for a -:ref:`Video Overlay <overlay>` or :ref:`Video Output Overlay <osd>`. + \end{adjustbox}\newline\newline + +.. note:: + + #) Bit 7 is the most significant bit; + + #) The value of a = alpha bits is undefined when reading from the driver, + ignored when writing to the driver, except when alpha blending has + been negotiated for a :ref:`Video Overlay <overlay>` or + :ref:`Video Output Overlay <osd>`.
Signature · 1 line
2.7.4
PATCH 9/20 docs-rst: remove width hints from pixfmt byte order tables
In reply to Mauro Carvalho ChehabThose hints are wrong, and doesn't really improve the look of those tables. So, keep them only when they're useful.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/pixfmt-grey.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-m420.rst | 6 ------ Documentation/media/uapi/v4l/pixfmt-nv12.rst | 6 ------ Documentation/media/uapi/v4l/pixfmt-nv12m.rst | 5 ----- Documentation/media/uapi/v4l/pixfmt-nv12mt.rst | 2 -- Documentation/media/uapi/v4l/pixfmt-nv16.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-nv16m.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-nv24.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-sbggr16.rst | 8 -------- Documentation/media/uapi/v4l/pixfmt-sbggr8.rst | 6 ------ Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst | 7 ------- Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst | 8 -------- Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst | 6 ------ Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-srggb10.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-srggb10alaw8.rst | 2 -- Documentation/media/uapi/v4l/pixfmt-srggb10p.rst | 12 ++++++++---- Documentation/media/uapi/v4l/pixfmt-srggb12.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-srggb8.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-uv8.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-uyvy.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-vyuy.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y10.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y10b.rst | 8 -------- Documentation/media/uapi/v4l/pixfmt-y12.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y12i.rst | 5 ----- Documentation/media/uapi/v4l/pixfmt-y16-be.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y16.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y41p.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-y8i.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv410.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv411p.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv420.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv420m.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv422m.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv422p.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuv444m.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yuyv.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-yvyu.rst | 3 --- Documentation/media/uapi/v4l/pixfmt-z16.rst | 3 --- 43 files changed, 8 insertions(+), 183 deletions(-)
Documentation/media/uapi/v4l/pixfmt-grey.rst +0 -7
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_GREY ('GREY') ************************** -*man V4L2_PIX_FMT_GREY(2)* - Grey-scale image
@@ -20,14 +18,9 @@ which simply contains no Cb or Cr data. **Byte Order.** Each cell is one byte. - - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-m420.rst +0 -6
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_M420 ('M420') ************************** -*man V4L2_PIX_FMT_M420(2)* - Format with ½ horizontal and vertical chroma resolution, also known as YUV 4:2:0. Hybrid plane line-interleaved layout.
@@ -32,13 +30,9 @@ the CbCr lines. Each cell is one byte. - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-nv12.rst +0 -6
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_NV12 ('NV12'), V4L2_PIX_FMT_NV21 ('NV21') ****************************************************** -*man V4L2_PIX_FMT_NV12(2)* V4L2_PIX_FMT_NV21 Formats with ½ horizontal and vertical chroma resolution, also known as
@@ -36,14 +35,9 @@ many pad bytes after its rows. Each cell is one byte. - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-nv12m.rst +0 -5
@@ -8,7 +8,6 @@ V4L2_PIX_FMT_NV12M ('NM12'), V4L2_PIX_FMT_NV21M ('NM21'), V4L2_PIX_FMT_NV12MT_16X16 *********************************************************************************** -*man V4L2_PIX_FMT_NV12M(2)* V4L2_PIX_FMT_NV21M V4L2_PIX_FMT_NV12MT_16X16
@@ -47,13 +46,9 @@ many pad bytes after its rows. **Byte Order.** Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-nv12mt.rst +0 -2
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_NV12MT ('TM12') **************************** -*man V4L2_PIX_FMT_NV12MT(2)* - Formats with ½ horizontal and vertical chroma resolution. This format has two planes - one for luminance and one for chrominance. Chroma samples are interleaved. The difference to ``V4L2_PIX_FMT_NV12`` is the
Documentation/media/uapi/v4l/pixfmt-nv16.rst +0 -7
@@ -7,8 +7,6 @@ V4L2_PIX_FMT_NV16 ('NV16'), V4L2_PIX_FMT_NV61 ('NV61') ****************************************************** -*man V4L2_PIX_FMT_NV16(2)* - V4L2_PIX_FMT_NV61 Formats with ½ horizontal chroma resolution, also known as YUV 4:2:2. One luminance and one chrominance plane with alternating chroma samples
@@ -35,14 +33,9 @@ many pad bytes after its rows. Each cell is one byte. - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-nv16m.rst +0 -7
@@ -7,8 +7,6 @@ V4L2_PIX_FMT_NV16M ('NM16'), V4L2_PIX_FMT_NV61M ('NM61') ******************************************************** -*man V4L2_PIX_FMT_NV16M(2)* - V4L2_PIX_FMT_NV61M Variation of ``V4L2_PIX_FMT_NV16`` and ``V4L2_PIX_FMT_NV61`` with planes non contiguous in memory.
@@ -38,14 +36,9 @@ described in :ref:`planar-apis`. Each cell is one byte. - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-nv24.rst +0 -7
@@ -7,8 +7,6 @@ V4L2_PIX_FMT_NV24 ('NV24'), V4L2_PIX_FMT_NV42 ('NV42') ****************************************************** -*man V4L2_PIX_FMT_NV24(2)* - V4L2_PIX_FMT_NV42 Formats with full horizontal and vertical chroma resolutions, also known as YUV 4:4:4. One luminance and one chrominance plane with alternating
@@ -35,14 +33,9 @@ twice as many pad bytes after its rows. Each cell is one byte. - -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-sbggr16.rst +0 -8
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_SBGGR16 ('BYR2') ***************************** -*man V4L2_PIX_FMT_SBGGR16(2)* - Bayer RGB format
@@ -27,15 +25,9 @@ memory addresses (little-endian). **Byte Order.** Each cell is one byte. - - -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-sbggr8.rst +0 -6
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_SBGGR8 ('BA81') **************************** -*man V4L2_PIX_FMT_SBGGR8(2)* - Bayer RGB format
@@ -25,13 +23,9 @@ scheme repeats to the right and down for every two columns and rows. Each cell is one byte. - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-sdr-cs08.rst +0 -7
@@ -6,8 +6,6 @@ V4L2_SDR_FMT_CS8 ('CS08') ************************* -*man V4L2_SDR_FMT_CS8(2)* - Complex signed 8-bit IQ sample
@@ -22,14 +20,9 @@ Q value after that. **Byte Order.** Each cell is one byte. - - -.. tabularcolumns:: |p{11.7cm}|p{5.8cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-sdr-cs14le.rst +0 -7
@@ -6,8 +6,6 @@ V4L2_SDR_FMT_CS14LE ('CS14') **************************** -*man V4L2_SDR_FMT_CS14LE(2)* - Complex signed 14-bit little endian IQ sample
@@ -24,14 +22,9 @@ space with unused high bits padded with 0. Each cell is one byte. - -.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-sdr-cu08.rst +0 -8
@@ -6,8 +6,6 @@ V4L2_SDR_FMT_CU8 ('CU08') ************************* -*man V4L2_SDR_FMT_CU8(2)* - Complex unsigned 8-bit IQ sample
@@ -22,15 +20,9 @@ and Q value after that. **Byte Order.** Each cell is one byte. - - -.. tabularcolumns:: |p{11.7cm}|p{5.8cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-sdr-cu16le.rst +0 -6
@@ -6,7 +6,6 @@ V4L2_SDR_FMT_CU16LE ('CU16') **************************** -*man V4L2_SDR_FMT_CU16LE(2)* Complex unsigned 16-bit little endian IQ sample
@@ -23,14 +22,9 @@ comes first and Q value after that. Each cell is one byte. - -.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-sdr-ru12le.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_SDR_FMT_RU12LE ('RU12') **************************** -*man V4L2_SDR_FMT_RU12LE(2)* Real unsigned 12-bit little endian sample
@@ -23,12 +22,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-sgbrg8.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_SGBRG8 ('GBRG') **************************** -*man V4L2_PIX_FMT_SGBRG8(2)* Bayer RGB format
@@ -26,12 +25,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-sgrbg8.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_SGRBG8 ('GRBG') **************************** -*man V4L2_PIX_FMT_SGRBG8(2)* Bayer RGB format
@@ -26,12 +25,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-srggb10.rst +0 -3
@@ -9,7 +9,6 @@ V4L2_PIX_FMT_SRGGB10 ('RG10'), V4L2_PIX_FMT_SGRBG10 ('BA10'), V4L2_PIX_FMT_SGBRG10 ('GB10'), V4L2_PIX_FMT_SBGGR10 ('BG10'), *************************************************************************************************************************** -*man V4L2_PIX_FMT_SRGGB10(2)* V4L2_PIX_FMT_SGRBG10 V4L2_PIX_FMT_SGBRG10
@@ -33,12 +32,10 @@ Each cell is one byte, high 6 bits in high bytes are 0. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-srggb10alaw8.rst +0 -2
@@ -9,8 +9,6 @@ V4L2_PIX_FMT_SBGGR10ALAW8 ('aBA8'), V4L2_PIX_FMT_SGBRG10ALAW8 ('aGA8'), V4L2_PIX_FMT_SGRBG10ALAW8 ('agA8'), V4L2_PIX_FMT_SRGGB10ALAW8 ('aRA8'), *********************************************************************************************************************************************** -*man V4L2_PIX_FMT_SBGGR10ALAW8(2)* - V4L2_PIX_FMT_SGBRG10ALAW8 V4L2_PIX_FMT_SGRBG10ALAW8 V4L2_PIX_FMT_SRGGB10ALAW8
Documentation/media/uapi/v4l/pixfmt-srggb10p.rst +8 -4
@@ -9,7 +9,6 @@ V4L2_PIX_FMT_SRGGB10P ('pRAA'), V4L2_PIX_FMT_SGRBG10P ('pgAA'), V4L2_PIX_FMT_SGBRG10P ('pGAA'), V4L2_PIX_FMT_SBGGR10P ('pBAA'), ******************************************************************************************************************************* -*man V4L2_PIX_FMT_SRGGB10P(2)* V4L2_PIX_FMT_SGRBG10P V4L2_PIX_FMT_SGBRG10P
@@ -34,15 +33,16 @@ of one of these formats: **Byte Order.** Each cell is one byte. +.. raw:: latex + \newline\newline\begin{adjustbox}{width=\columnwidth} -.. tabularcolumns:: |p{5.0cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}|p{2.5cm}| +.. tabularcolumns:: |p{2.0cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{1.3cm}|p{10.9cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 - + :widths: 12 8 8 8 8 68 - .. row 1
@@ -103,3 +103,7 @@ Each cell is one byte. - G\ :sub:`30low`\ (bits 7--6) R\ :sub:`31low`\ (bits 5--4) G\ :sub:`32low`\ (bits 3--2) R\ :sub:`33low`\ (bits 1--0) + +.. raw:: latex + + \end{adjustbox}\newline\newline
Documentation/media/uapi/v4l/pixfmt-srggb12.rst +0 -3
@@ -10,7 +10,6 @@ V4L2_PIX_FMT_SRGGB12 ('RG12'), V4L2_PIX_FMT_SGRBG12 ('BA12'), V4L2_PIX_FMT_SGBRG12 ('GB12'), V4L2_PIX_FMT_SBGGR12 ('BG12'), *************************************************************************************************************************** -*man V4L2_PIX_FMT_SRGGB12(2)* V4L2_PIX_FMT_SGRBG12 V4L2_PIX_FMT_SGBRG12
@@ -34,12 +33,10 @@ Each cell is one byte, high 6 bits in high bytes are 0. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-srggb8.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_SRGGB8 ('RGGB') **************************** -*man V4L2_PIX_FMT_SRGGB8(2)* Bayer RGB format
@@ -26,12 +25,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-uv8.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_UV8 ('UV8') ************************ -*man V4L2_PIX_FMT_UV8(2)* UV plane interleaved
@@ -21,12 +20,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-uyvy.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_UYVY ('UYVY') ************************** -*man V4L2_PIX_FMT_UYVY(2)* Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in memory
@@ -23,12 +22,10 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-vyuy.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_VYUY ('VYUY') ************************** -*man V4L2_PIX_FMT_VYUY(2)* Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in memory
@@ -23,12 +22,10 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y10.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y10 ('Y10 ') ************************* -*man V4L2_PIX_FMT_Y10(2)* Grey-scale image
@@ -23,12 +22,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y10b.rst +0 -8
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_Y10BPACK ('Y10B') ****************************** -*man V4L2_PIX_FMT_Y10BPACK(2)* - Grey-scale image as a bit-packed array
@@ -24,15 +22,9 @@ first from the left. pixels cross the byte boundary and have a ratio of 5 bytes for each 4 pixels. - - -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - - .. row 1
Documentation/media/uapi/v4l/pixfmt-y12.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y12 ('Y12 ') ************************* -*man V4L2_PIX_FMT_Y12(2)* Grey-scale image
@@ -23,12 +22,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y12i.rst +0 -5
@@ -6,8 +6,6 @@ V4L2_PIX_FMT_Y12I ('Y12I') ************************** -*man V4L2_PIX_FMT_Y12I(2)* - Interleaved grey-scale image, e.g. from a stereo-pair
@@ -29,12 +27,9 @@ these pixels can be deinterlaced using pixels cross the byte boundary and have a ratio of 3 bytes for each interleaved pixel. -.. tabularcolumns:: |p{8.8cm}|p{4.4cm}|p{4.3cm}| - .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y16-be.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y16_BE ('Y16 ' | (1 << 31)) **************************************** -*man V4L2_PIX_FMT_Y16_BE(2)* Grey-scale image
@@ -27,12 +26,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y16.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y16 ('Y16 ') ************************* -*man V4L2_PIX_FMT_Y16(2)* Grey-scale image
@@ -27,12 +26,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y41p.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y41P ('Y41P') ************************** -*man V4L2_PIX_FMT_Y41P(2)* Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1
@@ -30,12 +29,10 @@ Each cell is one byte. -.. 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}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-y8i.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Y8I ('Y8I ') ************************* -*man V4L2_PIX_FMT_Y8I(2)* Interleaved grey-scale image, e.g. from a stereo-pair
@@ -24,12 +23,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv410.rst +0 -3
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_YVU410 ('YVU9'), V4L2_PIX_FMT_YUV410 ('YUV9') ********************************************************** -*man V4L2_PIX_FMT_YVU410(2)* V4L2_PIX_FMT_YUV410 Planar formats with ¼ horizontal and vertical chroma resolution, also
@@ -37,12 +36,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv411p.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_YUV411P ('411P') ***************************** -*man V4L2_PIX_FMT_YUV411P(2)* Format with ¼ horizontal chroma resolution, also known as YUV 4:1:1. Planar layout as opposed to ``V4L2_PIX_FMT_Y41P``
@@ -33,12 +32,10 @@ have ¼ as many pad bytes after their rows. In other words, four C x rows Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv420.rst +0 -3
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_YVU420 ('YV12'), V4L2_PIX_FMT_YUV420 ('YU12') ********************************************************** -*man V4L2_PIX_FMT_YVU420(2)* V4L2_PIX_FMT_YUV420 Planar formats with ½ horizontal and vertical chroma resolution, also
@@ -38,12 +37,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv420m.rst +0 -3
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_YUV420M ('YM12'), V4L2_PIX_FMT_YVU420M ('YM21') ************************************************************ -*man V4L2_PIX_FMT_YUV420M(2)* V4L2_PIX_FMT_YVU420M Variation of ``V4L2_PIX_FMT_YUV420`` and ``V4L2_PIX_FMT_YVU420`` with
@@ -45,12 +44,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv422m.rst +0 -3
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_YUV422M ('YM16'), V4L2_PIX_FMT_YVU422M ('YM61') ************************************************************ -*man V4L2_PIX_FMT_YUV422M(2)* V4L2_PIX_FMT_YVU422M Planar formats with ½ horizontal resolution, also known as YUV and YVU
@@ -44,12 +43,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv422p.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_YUV422P ('422P') ***************************** -*man V4L2_PIX_FMT_YUV422P(2)* Format with ½ horizontal chroma resolution, also known as YUV 4:2:2. Planar layout as opposed to ``V4L2_PIX_FMT_YUYV``
@@ -34,12 +33,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuv444m.rst +0 -3
@@ -7,7 +7,6 @@ V4L2_PIX_FMT_YUV444M ('YM24'), V4L2_PIX_FMT_YVU444M ('YM42') ************************************************************ -*man V4L2_PIX_FMT_YUV444M(2)* V4L2_PIX_FMT_YVU444M Planar formats with full horizontal resolution, also known as YUV and
@@ -38,12 +37,10 @@ described in :ref:`planar-apis`. **Byte Order.** Each cell is one byte. -.. tabularcolumns:: |p{5.8cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{3.0cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yuyv.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_YUYV ('YUYV') ************************** -*man V4L2_PIX_FMT_YUYV(2)* Packed format with ½ horizontal chroma resolution, also known as YUV 4:2:2
@@ -26,12 +25,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-yvyu.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_YVYU ('YVYU') ************************** -*man V4L2_PIX_FMT_YVYU(2)* Variation of ``V4L2_PIX_FMT_YUYV`` with different order of samples in memory
@@ -23,12 +22,10 @@ half the horizontal resolution of the Y component. **Byte Order.** Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Documentation/media/uapi/v4l/pixfmt-z16.rst +0 -3
@@ -6,7 +6,6 @@ V4L2_PIX_FMT_Z16 ('Z16 ') ************************* -*man V4L2_PIX_FMT_Z16(2)* 16-bit depth data with distance values at each pixel
@@ -24,12 +23,10 @@ Each cell is one byte. -.. tabularcolumns:: |p{3.5cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.8cm}|p{1.4cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 2 1 1 1 1 1 1 1 1 - .. row 1
Signature · 1 line
2.7.4
PATCH 10/20 buffer.rst: Adjust table columns for LaTeX output
In reply to Mauro Carvalho ChehabThe table columns are not properly displayed. Also, some tables are too big to fit into just one page. So, fix them, in order to better display the tables.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/buffer.rst | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-)
Documentation/media/uapi/v4l/buffer.rst +14 -6
@@ -39,12 +39,14 @@ buffer. struct v4l2_buffer ================== -.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| +.. tabularcolumns:: |p{1.3cm}|p{2.5cm}|p{1.3cm}|p{12.0cm}| + +.. cssclass:: longtable .. flat-table:: struct v4l2_buffer :header-rows: 0 :stub-columns: 0 - :widths: 1 1 1 2 + :widths: 1 2 1 10 - .. row 1
@@ -286,6 +288,8 @@ struct v4l2_plane .. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| +.. cssclass:: longtable + .. flat-table:: :header-rows: 0 :stub-columns: 0
@@ -403,12 +407,14 @@ struct v4l2_plane enum v4l2_buf_type ================== -.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| +.. cssclass:: longtable + +.. tabularcolumns:: |p{7.2cm}|p{0.6cm}|p{9.7cm}| .. flat-table:: :header-rows: 0 :stub-columns: 0 - :widths: 3 1 4 + :widths: 4 1 9 - .. row 1
@@ -519,7 +525,9 @@ enum v4l2_buf_type Buffer Flags ============ -.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| +.. tabularcolumns:: |p{7.0cm}|p{2.2cm}|p{8.3cm}| + +.. cssclass:: longtable .. flat-table:: :header-rows: 0
@@ -953,7 +961,7 @@ Timecode Types Timecode Flags -------------- -.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| +.. tabularcolumns:: |p{6.6cm}|p{1.4cm}|p{9.5cm}| .. flat-table:: :header-rows: 0
Signature · 1 line
2.7.4
PATCH 11/20 dev-overlay.rst: don't ident a note
In reply to Mauro Carvalho ChehabThere's one note there that it is indented for no good reason. Fix it.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-overlay.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-)
Documentation/media/uapi/v4l/dev-overlay.rst +5 -5
@@ -238,12 +238,12 @@ exceeded are undefined. [#f3]_ :ref:`VIDIOC_S_FBUF <VIDIOC_G_FBUF>`, :ref:`framebuffer-flags`). - .. note:: +.. note:: - This field was added in Linux 2.6.23, extending the - structure. However the :ref:`VIDIOC_[G|S|TRY]_FMT <VIDIOC_G_FMT>` - ioctls, which take a pointer to a :ref:`v4l2_format <v4l2-format>` - parent structure with padding bytes at the end, are not affected. + This field was added in Linux 2.6.23, extending the + structure. However the :ref:`VIDIOC_[G|S|TRY]_FMT <VIDIOC_G_FMT>` + ioctls, which take a pointer to a :ref:`v4l2_format <v4l2-format>` + parent structure with padding bytes at the end, are not affected. .. _v4l2-clip:
Signature · 1 line
2.7.4
PATCH 12/20 dev-raw-vbi.rst: add a footnote for the count limits
In reply to Mauro Carvalho ChehabThere's a bug with LaTeX output on flat-tables with Sphinx 1.4.5 that prevents references at a cell span to be broken. As the text is indeed too long, it makes sense to place the reference to the pictures showing the VBI limits as a footnote.
That makes the text easier to read and also solves the issue with LaTeX output.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-raw-vbi.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-)
Documentation/media/uapi/v4l/dev-raw-vbi.rst +6 -4
@@ -196,10 +196,9 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does driver. Anyway, drivers may not support single field capturing and return both count values non-zero. - Both ``count`` values set to zero, or line numbers outside the - bounds depicted in :ref:`vbi-525` and :ref:`vbi-625`, or a - field image covering lines of two fields, are invalid and shall - not be returned by the driver. + Both ``count`` values set to zero, or line numbers are outside the + bounds depicted\ [#f4]_, or a field image covering lines of two + fields, are invalid and shall not be returned by the driver. To initialize the ``start`` and ``count`` fields, applications must first determine the current video standard selection. The
@@ -352,3 +351,6 @@ another process. Most VBI services transmit on both fields, but some have different semantics depending on the field number. These cannot be reliable decoded or encoded when ``V4L2_VBI_UNSYNC`` is set. + +.. [#f4] + The valid values ar shown at :ref:`vbi-525` and :ref:`vbi-625`.
Signature · 1 line
2.7.4
PATCH 13/20 dev-raw-vbi.rst: adjust table columns for LaTeX output
In reply to Mauro Carvalho ChehabAdd the needed tags to fix LaTeX output of the tables there.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-raw-vbi.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
Documentation/media/uapi/v4l/dev-raw-vbi.rst +4 -2
@@ -102,7 +102,9 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does .. _v4l2-vbi-format: -.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| +.. tabularcolumns:: |p{2.4cm}|p{4.4cm}|p{10.7cm}| + +.. cssclass:: longtable .. flat-table:: struct v4l2_vbi_format :header-rows: 0
@@ -228,7 +230,7 @@ and always returns default parameters as :ref:`VIDIOC_G_FMT <VIDIOC_G_FMT>` does .. _vbifmt-flags: -.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}| +.. tabularcolumns:: |p{4.0cm}|p{1.5cm}|p{12.0cm}| .. flat-table:: Raw VBI Format Flags :header-rows: 0
Signature · 1 line
2.7.4
PATCH 14/20 docs-rst: re-generate vbi_525.pdf and vbi_625.pdf
In reply to Mauro Carvalho ChehabOriginally, each image were one page big, causing them to be displayed on separate pages at the PDF output. Re-generate them from the gif files.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- .../media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf | Bin 3395 -> 3706 bytes .../media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf | Bin 3683 -> 3996 bytes 2 files changed, 0 insertions(+), 0 deletions(-)
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_525.pdf binary +0 -0
Documentation/media/uapi/v4l/dev-raw-vbi_files/vbi_625.pdf binary +0 -0
Signature · 1 line
2.7.4
PATCH 15/20 dev-sliced-vbi.rst: use a footnote for VBI images
In reply to Mauro Carvalho ChehabJust like on dvb-raw-vbi.rst, the LaTeX output doesn't work well with cell spans. Also, this is actually a note, so, move it to a footnote.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-sliced-vbi.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
Documentation/media/uapi/v4l/dev-sliced-vbi.rst +4 -2
@@ -155,8 +155,7 @@ struct v4l2_sliced_vbi_format service the driver chooses. Data services are defined in :ref:`vbi-services2`. Array indices - map to ITU-R line numbers (see also :ref:`vbi-525` and - :ref:`vbi-625`) as follows: + map to ITU-R line numbers\ [#f2]_ as follows: - .. row 3
@@ -838,3 +837,6 @@ Line Identifiers for struct v4l2_mpeg_vbi_itv0_line id field .. [#f1] According to :ref:`ETS 300 706 <ets300706>` lines 6-22 of the first field and lines 5-22 of the second field may carry Teletext data. + +.. [#f2] + See also :ref:`vbi-525` and :ref:`vbi-625`.
Signature · 1 line
2.7.4
PATCH 16/20 dev-sliced-vbi.rst: Adjust tables on LaTeX output
In reply to Mauro Carvalho ChehabBetter format the tables in a way that will fit inside the page.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-sliced-vbi.rst | 34 +++++++++++++++++-------- 1 file changed, 24 insertions(+), 10 deletions(-)
Documentation/media/uapi/v4l/dev-sliced-vbi.rst +24 -10
@@ -105,7 +105,9 @@ which may return ``EBUSY`` can be the struct v4l2_sliced_vbi_format ----------------------------- -.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}| +.. tabularcolumns:: |p{1.0cm}|p{4.5cm}|p{4.0cm}|p{4.0cm}|p{4.0cm}| + +.. cssclass:: longtable .. flat-table:: :header-rows: 0
@@ -242,16 +244,20 @@ struct v4l2_sliced_vbi_format - ``reserved``\ [2] - :cspan:`2` This array is reserved for future extensions. + Applications and drivers must set it to zero. - .. _vbi-services2: Sliced VBI services ------------------- -.. tabularcolumns:: |p{4.4cm}|p{2.2cm}|p{2.2cm}|p{4.4cm}|p{4.3cm}| +.. raw:: latex + + \newline\newline\begin{adjustbox}{width=\columnwidth} + +.. tabularcolumns:: |p{5.0cm}|p{1.4cm}|p{3.0cm}|p{2.5cm}|p{9.0cm}| .. flat-table:: :header-rows: 1
@@ -277,7 +283,9 @@ Sliced VBI services - 0x0001 - - :ref:`ets300706`, :ref:`itu653` + - :ref:`ets300706`, + + :ref:`itu653` - PAL/SECAM line 7-22, 320-335 (second field 7-22)
@@ -316,7 +324,9 @@ Sliced VBI services - 0x4000 - - :ref:`itu1119`, :ref:`en300294` + - :ref:`itu1119`, + + :ref:`en300294` - PAL/SECAM line 23
@@ -344,6 +354,10 @@ Sliced VBI services - :cspan:`2` Set of services applicable to 625 line systems. +.. raw:: latex + + \end{adjustbox}\newline\newline + Drivers may return an ``EINVAL`` error code when applications attempt to read or write data without prior format negotiation, after switching the
@@ -561,7 +575,7 @@ number). struct v4l2_mpeg_vbi_fmt_ivtv ----------------------------- -.. tabularcolumns:: |p{3.5cm}|p{3.5cm}|p{3.5cm}|p{7.0cm}| +.. tabularcolumns:: |p{1.0cm}|p{3.5cm}|p{1.0cm}|p{11.5cm}| .. flat-table:: :header-rows: 0
@@ -661,7 +675,7 @@ Magic Constants for struct v4l2_mpeg_vbi_fmt_ivtv magic field struct v4l2_mpeg_vbi_itv0 ------------------------- -.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| +.. tabularcolumns:: |p{4.4cm}|p{2.4cm}|p{10.7cm}| .. flat-table:: :header-rows: 0
@@ -687,9 +701,9 @@ struct v4l2_mpeg_vbi_itv0 :: linemask[0] b0: line 6 first field - linemask[0] b17: line 23 first field - linemask[0] b18: line 6 second field - linemask[0] b31: line 19 second field + linemask[0] b17: line 23 first field + linemask[0] b18: line 6 second field + linemask[0] b31: line 19 second field linemask[1] b0: line 20 second field linemask[1] b3: line 23 second field linemask[1] b4-b31: unused and set to 0
Signature · 1 line
2.7.4
PATCH 17/20 dev-rds.rst: adjust table dimentions for LaTeX
In reply to Mauro Carvalho ChehabOne of the tables has wrong column dimentions. Fix it.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-rds.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/media/uapi/v4l/dev-rds.rst +1 -1
@@ -170,7 +170,7 @@ RDS datastructures .. _v4l2-rds-block-codes: -.. tabularcolumns:: |p{2.2cm}|p{2.2cm}|p{2.2cm}|p{10.9cm}| +.. tabularcolumns:: |p{5.6cm}|p{2.0cm}|p{1.5cm}|p{7.0cm}| .. flat-table:: Block defines :header-rows: 0
Signature · 1 line
2.7.4
PATCH 18/20 dev-subdev.rst: make table fully visible on LaTeX
In reply to Mauro Carvalho ChehabThe table there is too big and doesn't have format hints for LaTeX output.
Fix it.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/dev-subdev.rst | 9 +++++++++ 1 file changed, 9 insertions(+)
Documentation/media/uapi/v4l/dev-subdev.rst +9 -0
@@ -204,9 +204,16 @@ list entity names and pad numbers). .. _sample-pipeline-config: +.. raw:: latex + + \newline\newline\begin{adjustbox}{width=\columnwidth} + +.. tabularcolumns:: |p{4.5cm}|p{4.5cm}|p{4.5cm}|p{4.5cm}|p{4.5cm}|p{4.5cm}|p{4.5cm}| + .. flat-table:: Sample Pipeline Configuration :header-rows: 1 :stub-columns: 0 + :widths: 5 5 5 5 5 5 5 - .. row 1
@@ -288,7 +295,9 @@ list entity names and pad numbers). - *1280x960/SGRBG8_1X8* +.. raw:: latex + \end{adjustbox}\newline\newline 1. Initial state. The sensor source pad format is set to its native 3MP size and V4L2_MBUS_FMT_SGRBG8_1X8 media bus code. Formats on the
Signature · 1 line
2.7.4
PATCH 19/20 subdev-formats.rst: adjust most of the tables to fill in page
In reply to Mauro Carvalho ChehabFix mosto fo the tables there in order to make them fit at the page size.
There are, however, two exceptions: RGB and YUV big tables, where adding the raw latex adjustbox caused the tables to not be properly formatted. I suspect that the problem is because those are long tables, but not really sure.
The thing is that Sphinx lacks an "adjustbox" tag that would avoid the raw latex hacks.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/subdev-formats.rst | 5575 ++++++++++++----------- 1 file changed, 2806 insertions(+), 2769 deletions(-)
Documentation/media/uapi/v4l/subdev-formats.rst +2806 -2769
@@ -155,12 +155,16 @@ half of the green value) transferred first will be named The following tables list existing packed RGB formats. +.. FIXME: I was unable to find a way to use adjustbox or landscape for this table! + +.. tabularcolumns:: |p{7.6cm}|p{1.6cm}|p{0.7cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{-1.0cm}| .. _v4l2-mbus-pixelcode-rgb: .. flat-table:: RGB formats :header-rows: 2 :stub-columns: 0 + :widths: 36 7 3 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 - .. row 1
@@ -249,45 +253,45 @@ The following tables list existing packed RGB formats. - 0x1016 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`3`
@@ -320,53 +324,53 @@ The following tables list existing packed RGB formats. - 0x1001 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - 0
@@ -389,53 +393,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`3`
@@ -460,53 +464,53 @@ The following tables list existing packed RGB formats. - 0x1002 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`3`
@@ -529,53 +533,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - 0
@@ -600,53 +604,53 @@ The following tables list existing packed RGB formats. - 0x1003 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - 0
@@ -669,53 +673,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -740,53 +744,53 @@ The following tables list existing packed RGB formats. - 0x1004 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -809,53 +813,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - 0
@@ -880,37 +884,37 @@ The following tables list existing packed RGB formats. - 0x1017 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`4`
@@ -951,53 +955,53 @@ The following tables list existing packed RGB formats. - 0x1005 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`4`
@@ -1020,53 +1024,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -1091,53 +1095,53 @@ The following tables list existing packed RGB formats. - 0x1006 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -1160,53 +1164,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`4`
@@ -1231,53 +1235,53 @@ The following tables list existing packed RGB formats. - 0x1007 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`4`
@@ -1300,53 +1304,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -1371,53 +1375,53 @@ The following tables list existing packed RGB formats. - 0x1008 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`2`
@@ -1440,53 +1444,53 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`4`
@@ -1511,33 +1515,33 @@ The following tables list existing packed RGB formats. - 0x1009 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`5`
@@ -1582,21 +1586,21 @@ The following tables list existing packed RGB formats. - 0x100e - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -1653,21 +1657,21 @@ The following tables list existing packed RGB formats. - 0x1015 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - 0
@@ -1724,21 +1728,21 @@ The following tables list existing packed RGB formats. - 0x1013 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -1795,21 +1799,21 @@ The following tables list existing packed RGB formats. - 0x1014 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -1866,21 +1870,21 @@ The following tables list existing packed RGB formats. - 0x100a - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -1937,45 +1941,45 @@ The following tables list existing packed RGB formats. - 0x100b - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -2006,45 +2010,45 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`3`
@@ -2077,45 +2081,45 @@ The following tables list existing packed RGB formats. - 0x100c - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`3`
@@ -2146,45 +2150,45 @@ The following tables list existing packed RGB formats. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -2352,7 +2356,6 @@ The following tables list existing packed RGB formats. - b\ :sub:`0` - On LVDS buses, usually each sample is transferred serialized in seven time slots per pixel clock, on three (18-bit) or four (24-bit) differential data pairs at the same time. The remaining bits are used
@@ -2361,6 +2364,9 @@ for control signals as defined by SPWG/PSWG/VESA or JEIDA standards. The JEIDA defined bit mapping will be named ``MEDIA_BUS_FMT_RGB888_1X7X4_JEIDA``, for example. +.. raw:: latex + + \newline\newline\begin{adjustbox}{width=\columnwidth} .. _v4l2-mbus-pixelcode-rgb-lvds:
@@ -2404,7 +2410,7 @@ JEIDA defined bit mapping will be named - 0 - - - - + - - d
@@ -2419,7 +2425,7 @@ JEIDA defined bit mapping will be named - 1 - - - - + - - d
@@ -2434,7 +2440,7 @@ JEIDA defined bit mapping will be named - 2 - - - - + - - d
@@ -2449,7 +2455,7 @@ JEIDA defined bit mapping will be named - 3 - - - - + - - b\ :sub:`5`
@@ -2464,7 +2470,7 @@ JEIDA defined bit mapping will be named - 4 - - - - + - - b\ :sub:`4`
@@ -2479,7 +2485,7 @@ JEIDA defined bit mapping will be named - 5 - - - - + - - b\ :sub:`3`
@@ -2494,7 +2500,7 @@ JEIDA defined bit mapping will be named - 6 - - - - + - - b\ :sub:`2`
@@ -2716,6 +2722,9 @@ JEIDA defined bit mapping will be named - r\ :sub:`2` +.. raw:: latex + + \end{adjustbox}\newline\newline Bayer Formats
@@ -2770,8 +2779,16 @@ The following table lists existing packed Bayer formats. The data organization is given as an example for the first pixel only. +.. raw:: latex + + \newline\newline\begin{adjustbox}{width=\columnwidth} + +.. tabularcolumns:: |p{7.6cm}|p{1.6cm}|p{0.7cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}| + .. _v4l2-mbus-pixelcode-bayer: +.. cssclass: longtable + .. flat-table:: Bayer Formats :header-rows: 2 :stub-columns: 0
@@ -2823,13 +2840,13 @@ organization is given as an example for the first pixel only. - 0x3001 - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -2854,13 +2871,13 @@ organization is given as an example for the first pixel only. - 0x3013 - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -2885,13 +2902,13 @@ organization is given as an example for the first pixel only. - 0x3002 - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -2916,13 +2933,13 @@ organization is given as an example for the first pixel only. - 0x3014 - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -2947,13 +2964,13 @@ organization is given as an example for the first pixel only. - 0x3015 - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -2978,13 +2995,13 @@ organization is given as an example for the first pixel only. - 0x3016 - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -3009,13 +3026,13 @@ organization is given as an example for the first pixel only. - 0x3017 - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -3040,13 +3057,13 @@ organization is given as an example for the first pixel only. - 0x3018 - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -3071,13 +3088,13 @@ organization is given as an example for the first pixel only. - 0x300b - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -3102,13 +3119,13 @@ organization is given as an example for the first pixel only. - 0x300c - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -3133,13 +3150,13 @@ organization is given as an example for the first pixel only. - 0x3009 - - - - + - - - - + - - - - + - - - - + - - g\ :sub:`7`
@@ -3164,13 +3181,13 @@ organization is given as an example for the first pixel only. - 0x300d - - - - + - - - - + - - - - + - - - - + - - r\ :sub:`7`
@@ -3195,13 +3212,13 @@ organization is given as an example for the first pixel only. - 0x3003 - - - - + - - - - + - - - - + - - - - + - - 0
@@ -3224,13 +3241,13 @@ organization is given as an example for the first pixel only. - - - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -3255,13 +3272,13 @@ organization is given as an example for the first pixel only. - 0x3004 - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`7`
@@ -3284,13 +3301,13 @@ organization is given as an example for the first pixel only. - - - - - - + - - - - + - - - - + - - - - + - - 0
@@ -3315,13 +3332,13 @@ organization is given as an example for the first pixel only. - 0x3005 - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`9`
@@ -3344,13 +3361,13 @@ organization is given as an example for the first pixel only. - - - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`1`
@@ -3375,13 +3392,13 @@ organization is given as an example for the first pixel only. - 0x3006 - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`1`
@@ -3404,13 +3421,13 @@ organization is given as an example for the first pixel only. - - - - - - + - - - - + - - - - + - - - - + - - b\ :sub:`9`
@@ -3435,9 +3452,9 @@ organization is given as an example for the first pixel only. - 0x3007 - - - - + - - - - + - - b\ :sub:`9`
@@ -3466,9 +3483,9 @@ organization is given as an example for the first pixel only. - 0x300e - - - - + - - - - + - - g\ :sub:`9`
@@ -3497,9 +3514,9 @@ organization is given as an example for the first pixel only. - 0x300a - - - - + - - - - + - - g\ :sub:`9`
@@ -3528,9 +3545,9 @@ organization is given as an example for the first pixel only. - 0x300f - - - - + - - - - + - - r\ :sub:`9`
@@ -3676,6 +3693,9 @@ organization is given as an example for the first pixel only. - r\ :sub:`0` +.. raw:: latex + + \end{adjustbox}\newline\newline Packed YUV Formats
@@ -3728,17 +3748,22 @@ the following codes. - a\ :sub:`x` for alpha component bit number x -- - for non-available bits (for positions higher than the bus width) +- for non-available bits (for positions higher than the bus width) - d for dummy bits +.. FIXME: I was unable to find a way to use adjustbox or landscape for this table! + +.. tabularcolumns:: |p{7.6cm}|p{1.6cm}|p{0.7cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{0.5cm}|p{-1.0cm}| .. _v4l2-mbus-pixelcode-yuv8: +.. cssclass: longtable + .. flat-table:: YUV Formats :header-rows: 2 :stub-columns: 0 - + :widths: 36 7 3 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 - .. row 1
@@ -3826,53 +3851,53 @@ the following codes. - 0x2001 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - y\ :sub:`7`
@@ -3897,53 +3922,53 @@ the following codes. - 0x2015 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - u\ :sub:`7`
@@ -3966,53 +3991,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - v\ :sub:`7`
@@ -4037,53 +4062,53 @@ the following codes. - 0x2002 - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - u\ :sub:`7`
@@ -4106,53 +4131,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - y\ :sub:`7`
@@ -4175,53 +4200,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - y\ :sub:`7`
@@ -4244,53 +4269,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - v\ :sub:`7`
@@ -4313,53 +4338,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - y\ :sub:`7`
@@ -4382,53 +4407,53 @@ the following codes. - - - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - -
Lines of this file are not shown. View the raw message.
The rest of this diff is not shown. View the raw message.
Signature · 1 line
2.7.4
Part of the diff is not shown here. View the raw message.
PATCH 20/20 diff-v4l.rst: Make capabilities table fit in LaTeX
In reply to Mauro Carvalho ChehabThis table has several troubles:
- a duplicated "struct" on its name;
- a reference to a V4L version 1 struct that will never point to something (as we got rid of V4L1 API a long time ago);
- misses hints for LaTeX output (column size and longtable style).
Fix them.
It should be noticed that the first column of this table is not aligned with the rest. I suspect that this is a bug at the flat-table extension.
Signed-off-by Mauro Carvalho Chehab <[email protected]>
--- Documentation/media/uapi/v4l/diff-v4l.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-)
Documentation/media/uapi/v4l/diff-v4l.rst +3 -1
@@ -95,7 +95,9 @@ and radio devices supporting a set of related functions like video capturing, video overlay and VBI capturing. See :ref:`open` for an introduction. +.. tabularcolumns:: |p{5.5cm}|p{6.5cm}|p{5.5cm} +.. cssclass:: longtable .. flat-table:: :header-rows: 1
@@ -104,7 +106,7 @@ introduction. - .. row 1 - - struct :c:type:`struct video_capability` ``type`` + - ``struct video_capability`` ``type`` - struct :ref:`v4l2_capability <v4l2-capability>` ``capabilities`` flags
Signature · 1 line
2.7.4