1.. Permission is granted to copy, distribute and/or modify this
2.. document under the terms of the GNU Free Documentation License,
3.. Version 1.1 or any later version published by the Free Software
4.. Foundation, with no Invariant Sections, no Front-Cover Texts
5.. and no Back-Cover Texts. A copy of the license is included at
6.. Documentation/userspace-api/media/fdl-appendix.rst.
7..
8.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9
10.. _pixfmt:
11
12#############
13Image Formats
14#############
15The V4L2 API was primarily designed for devices exchanging image data
16with applications. The struct :c:type:`v4l2_pix_format` and
17struct :c:type:`v4l2_pix_format_mplane` structures define the
18format and layout of an image in memory. The former is used with the
19single-planar API, while the latter is used with the multi-planar
20version (see :ref:`planar-apis`). Image formats are negotiated with
21the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here
22focus on video capturing and output, for overlay frame buffer formats
23see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.)
24
25
26.. toctree::
27    :maxdepth: 1
28
29    pixfmt-v4l2
30    pixfmt-v4l2-mplane
31    pixfmt-intro
32    pixfmt-indexed
33    pixfmt-rgb
34    pixfmt-bayer
35    yuv-formats
36    hsv-formats
37    depth-formats
38    pixfmt-compressed
39    sdr-formats
40    tch-formats
41    meta-formats
42    pixfmt-reserved
43    colorspaces
44    colorspaces-defs
45    colorspaces-details
46