1059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 254f38fcaSMauro Carvalho Chehab 354f38fcaSMauro Carvalho Chehab.. _pixfmt: 454f38fcaSMauro Carvalho Chehab 554f38fcaSMauro Carvalho Chehab############# 654f38fcaSMauro Carvalho ChehabImage Formats 754f38fcaSMauro Carvalho Chehab############# 854f38fcaSMauro Carvalho ChehabThe V4L2 API was primarily designed for devices exchanging image data 954f38fcaSMauro Carvalho Chehabwith applications. The struct :c:type:`v4l2_pix_format` and 1054f38fcaSMauro Carvalho Chehabstruct :c:type:`v4l2_pix_format_mplane` structures define the 1154f38fcaSMauro Carvalho Chehabformat and layout of an image in memory. The former is used with the 1254f38fcaSMauro Carvalho Chehabsingle-planar API, while the latter is used with the multi-planar 1354f38fcaSMauro Carvalho Chehabversion (see :ref:`planar-apis`). Image formats are negotiated with 1454f38fcaSMauro Carvalho Chehabthe :ref:`VIDIOC_S_FMT <VIDIOC_G_FMT>` ioctl. (The explanations here 1554f38fcaSMauro Carvalho Chehabfocus on video capturing and output, for overlay frame buffer formats 1654f38fcaSMauro Carvalho Chehabsee also :ref:`VIDIOC_G_FBUF <VIDIOC_G_FBUF>`.) 1754f38fcaSMauro Carvalho Chehab 1854f38fcaSMauro Carvalho Chehab 1954f38fcaSMauro Carvalho Chehab.. toctree:: 2054f38fcaSMauro Carvalho Chehab :maxdepth: 1 2154f38fcaSMauro Carvalho Chehab 2254f38fcaSMauro Carvalho Chehab pixfmt-v4l2 2354f38fcaSMauro Carvalho Chehab pixfmt-v4l2-mplane 2454f38fcaSMauro Carvalho Chehab pixfmt-intro 2554f38fcaSMauro Carvalho Chehab pixfmt-indexed 2654f38fcaSMauro Carvalho Chehab pixfmt-rgb 2754f38fcaSMauro Carvalho Chehab pixfmt-bayer 2854f38fcaSMauro Carvalho Chehab yuv-formats 2954f38fcaSMauro Carvalho Chehab hsv-formats 3054f38fcaSMauro Carvalho Chehab depth-formats 3154f38fcaSMauro Carvalho Chehab pixfmt-compressed 3254f38fcaSMauro Carvalho Chehab sdr-formats 3354f38fcaSMauro Carvalho Chehab tch-formats 3454f38fcaSMauro Carvalho Chehab meta-formats 3554f38fcaSMauro Carvalho Chehab pixfmt-reserved 3654f38fcaSMauro Carvalho Chehab colorspaces 3754f38fcaSMauro Carvalho Chehab colorspaces-defs 3854f38fcaSMauro Carvalho Chehab colorspaces-details 39