summaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook/v4l/vidioc-g-fmt.xml
diff options
context:
space:
mode:
authorPawel Osciak <pawel@osciak.com>2011-01-07 01:41:33 -0300
committerMauro Carvalho Chehab <mchehab@redhat.com>2011-03-21 20:31:35 -0300
commit53b5d5749b6fcca37c7ad60cd40feafadd390b70 (patch)
tree136a77c82f6913607af0ac575d66880b12bc65d2 /Documentation/DocBook/v4l/vidioc-g-fmt.xml
parentc4c0a78d459f2e4fcc7c4f3621a34e71ec7970d0 (diff)
downloadop-kernel-dev-53b5d5749b6fcca37c7ad60cd40feafadd390b70.zip
op-kernel-dev-53b5d5749b6fcca37c7ad60cd40feafadd390b70.tar.gz
[media] Add multi-planar API documentation
Add DocBook documentation for the new multi-planar API extensions to the Video for Linux 2 API DocBook. Signed-off-by: Pawel Osciak <pawel@osciak.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook/v4l/vidioc-g-fmt.xml')
-rw-r--r--Documentation/DocBook/v4l/vidioc-g-fmt.xml15
1 files changed, 13 insertions, 2 deletions
diff --git a/Documentation/DocBook/v4l/vidioc-g-fmt.xml b/Documentation/DocBook/v4l/vidioc-g-fmt.xml
index 7c7d1b7..a4ae59b 100644
--- a/Documentation/DocBook/v4l/vidioc-g-fmt.xml
+++ b/Documentation/DocBook/v4l/vidioc-g-fmt.xml
@@ -60,11 +60,13 @@ application.</para>
<structfield>type</structfield> field of a struct
<structname>v4l2_format</structname> to the respective buffer (stream)
type. For example video capture devices use
-<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant>. When the application
+<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE</constant> or
+<constant>V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE</constant>. When the application
calls the <constant>VIDIOC_G_FMT</constant> ioctl with a pointer to
this structure the driver fills the respective member of the
<structfield>fmt</structfield> union. In case of video capture devices
-that is the &v4l2-pix-format; <structfield>pix</structfield> member.
+that is either the &v4l2-pix-format; <structfield>pix</structfield> or
+the &v4l2-pix-format-mplane; <structfield>pix_mp</structfield> member.
When the requested buffer type is not supported drivers return an
&EINVAL;.</para>
@@ -134,6 +136,15 @@ devices.</entry>
</row>
<row>
<entry></entry>
+ <entry>&v4l2-pix-format-mplane;</entry>
+ <entry><structfield>pix_mp</structfield></entry>
+ <entry>Definition of an image format, see <xref
+ linkend="pixfmt" />, used by video capture and output
+devices that support the <link linkend="planar-apis">multi-planar
+version of the API</link>.</entry>
+ </row>
+ <row>
+ <entry></entry>
<entry>&v4l2-window;</entry>
<entry><structfield>win</structfield></entry>
<entry>Definition of an overlaid image, see <xref
OpenPOWER on IntegriCloud