1.. -*- coding: utf-8; mode: rst -*- 2 3.. _pixfmt: 4 5############# 6Image Formats 7############# 8The V4L2 API was primarily designed for devices exchanging image data 9with applications. The struct :c:type:`v4l2_pix_format` and 10struct :c:type:`v4l2_pix_format_mplane` structures define the 11format and layout of an image in memory. The former is used with the 12single-planar API, while the latter is used with the multi-planar 13version (see :ref:`planar-apis`). Image formats are negotiated with 14the :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here 15focus on video capturing and output, for overlay frame buffer formats 16see also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.) 17 18 19.. toctree:: 20 :maxdepth: 1 21 22 pixfmt-v4l2 23 pixfmt-v4l2-mplane 24 pixfmt-intro 25 pixfmt-indexed 26 pixfmt-rgb 27 yuv-formats 28 hsv-formats 29 depth-formats 30 pixfmt-compressed 31 sdr-formats 32 tch-formats 33 meta-formats 34 pixfmt-reserved 35 colorspaces 36 colorspaces-defs 37 colorspaces-details 38