blob: 2aa449e2da67246175f9c83b6a5df4d104cbd9e6 [file] [log] [blame]
.. -*- coding: utf-8; mode: rst -*-
.. _pixfmt:
#############
Image Formats
#############
The V4L2 API was primarily designed for devices exchanging image data
with applications. The struct :c:type:`v4l2_pix_format` and
struct :c:type:`v4l2_pix_format_mplane` structures define the
format and layout of an image in memory. The former is used with the
single-planar API, while the latter is used with the multi-planar
version (see :ref:`planar-apis`). Image formats are negotiated with
the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here
focus on video capturing and output, for overlay frame buffer formats
see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.)
.. toctree::
:maxdepth: 1
pixfmt-v4l2
pixfmt-v4l2-mplane
pixfmt-intro
pixfmt-indexed
pixfmt-rgb
yuv-formats
hsv-formats
depth-formats
pixfmt-compressed
sdr-formats
tch-formats
meta-formats
pixfmt-reserved
colorspaces
colorspaces-defs
colorspaces-details