1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !! 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
2 9
3 .. _pixfmt: 10 .. _pixfmt:
4 11
5 ############# 12 #############
6 Image Formats 13 Image Formats
7 ############# 14 #############
8 The V4L2 API was primarily designed for device 15 The V4L2 API was primarily designed for devices exchanging image data
9 with applications. The struct :c:type:`v4l2_pi 16 with applications. The struct :c:type:`v4l2_pix_format` and
10 struct :c:type:`v4l2_pix_format_mplane` struct 17 struct :c:type:`v4l2_pix_format_mplane` structures define the
11 format and layout of an image in memory. The f 18 format and layout of an image in memory. The former is used with the
12 single-planar API, while the latter is used wi 19 single-planar API, while the latter is used with the multi-planar
13 version (see :ref:`planar-apis`). Image format 20 version (see :ref:`planar-apis`). Image formats are negotiated with
14 the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. 21 the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here
15 focus on video capturing and output, for overl 22 focus on video capturing and output, for overlay frame buffer formats
16 see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`. 23 see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.)
17 24
18 25
19 .. toctree:: 26 .. toctree::
20 :maxdepth: 1 27 :maxdepth: 1
21 28
22 pixfmt-v4l2 29 pixfmt-v4l2
23 pixfmt-v4l2-mplane 30 pixfmt-v4l2-mplane
24 pixfmt-intro 31 pixfmt-intro
25 pixfmt-indexed 32 pixfmt-indexed
26 pixfmt-rgb 33 pixfmt-rgb
27 pixfmt-bayer 34 pixfmt-bayer
28 yuv-formats 35 yuv-formats
29 hsv-formats 36 hsv-formats
30 depth-formats 37 depth-formats
31 pixfmt-compressed 38 pixfmt-compressed
32 sdr-formats 39 sdr-formats
33 tch-formats 40 tch-formats
34 meta-formats 41 meta-formats
35 pixfmt-reserved 42 pixfmt-reserved
36 colorspaces 43 colorspaces
37 colorspaces-defs 44 colorspaces-defs
38 colorspaces-details 45 colorspaces-details
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.