• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 <partinfo>
2    <authorgroup>
3      <author>
4	<firstname>Michael</firstname>
5	<surname>Schimek</surname>
6	<othername role="mi">H</othername>
7	<affiliation>
8	  <address>
9	    <email>mschimek@gmx.at</email>
10	  </address>
11	</affiliation>
12      </author>
13
14      <author>
15	<firstname>Bill</firstname>
16	<surname>Dirks</surname>
17	<!-- Commented until Bill opts in to be spammed.
18	<affiliation>
19	  <address>
20	    <email>bill@thedirks.org</email>
21	  </address>
22	</affiliation> -->
23	<contrib>Original author of the V4L2 API and
24documentation.</contrib>
25      </author>
26
27      <author>
28	<firstname>Hans</firstname>
29	<surname>Verkuil</surname>
30	<contrib>Designed and documented the VIDIOC_LOG_STATUS ioctl,
31the extended control ioctls, major parts of the sliced VBI API, the
32MPEG encoder and decoder APIs and the DV Timings API.</contrib>
33	<affiliation>
34	  <address>
35	    <email>hverkuil@xs4all.nl</email>
36	  </address>
37	</affiliation>
38      </author>
39
40      <author>
41	<firstname>Martin</firstname>
42	<surname>Rubli</surname>
43	<!--
44	<affiliation>
45	  <address>
46	    <email>martin_rubli@logitech.com</email>
47	  </address>
48	</affiliation> -->
49	<contrib>Designed and documented the VIDIOC_ENUM_FRAMESIZES
50and VIDIOC_ENUM_FRAMEINTERVALS ioctls.</contrib>
51      </author>
52
53      <author>
54	<firstname>Andy</firstname>
55	<surname>Walls</surname>
56	<contrib>Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV
57MPEG stream embedded, sliced VBI data format in this specification.
58</contrib>
59	<affiliation>
60	  <address>
61	    <email>awalls@md.metrocast.net</email>
62	  </address>
63	</affiliation>
64      </author>
65
66      <author>
67	<firstname>Mauro</firstname>
68	<surname>Carvalho Chehab</surname>
69	<contrib>Documented libv4l, designed and added v4l2grab example,
70Remote Controller chapter.</contrib>
71	<affiliation>
72	  <address>
73	    <email>m.chehab@samsung.com</email>
74	  </address>
75	</affiliation>
76      </author>
77
78      <author>
79	<firstname>Muralidharan</firstname>
80	<surname>Karicheri</surname>
81	<contrib>Documented the Digital Video timings API.</contrib>
82	<affiliation>
83	  <address>
84	    <email>m-karicheri2@ti.com</email>
85	  </address>
86	</affiliation>
87      </author>
88
89      <author>
90	<firstname>Pawel</firstname>
91	<surname>Osciak</surname>
92	<contrib>Designed and documented the multi-planar API.</contrib>
93	<affiliation>
94	  <address>
95	    <email>pawel AT osciak.com</email>
96	  </address>
97	</affiliation>
98      </author>
99
100      <author>
101	<firstname>Sakari</firstname>
102	<surname>Ailus</surname>
103	<contrib>Subdev selections API.</contrib>
104	<affiliation>
105	  <address>
106	    <email>sakari.ailus@iki.fi</email>
107	  </address>
108	</affiliation>
109      </author>
110      <author>
111	<firstname>Antti</firstname>
112	<surname>Palosaari</surname>
113	<contrib>SDR API.</contrib>
114	<affiliation>
115	  <address>
116	    <email>crope@iki.fi</email>
117	  </address>
118	</affiliation>
119      </author>
120    </authorgroup>
121
122    <copyright>
123      <year>1999</year>
124      <year>2000</year>
125      <year>2001</year>
126      <year>2002</year>
127      <year>2003</year>
128      <year>2004</year>
129      <year>2005</year>
130      <year>2006</year>
131      <year>2007</year>
132      <year>2008</year>
133      <year>2009</year>
134      <year>2010</year>
135      <year>2011</year>
136      <year>2012</year>
137      <year>2013</year>
138      <year>2014</year>
139      <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
140Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
141	Pawel Osciak</holder>
142    </copyright>
143    <legalnotice>
144    <para>Except when explicitly stated as GPL, programming examples within
145	    this part can be used and distributed without restrictions.</para>
146    </legalnotice>
147    <revhistory>
148      <!-- Put document revisions here, newest first. -->
149      <!-- API revisions (changes and additions of defines, enums,
150structs, ioctls) must be noted in more detail in the history chapter
151(compat.xml), along with the possible impact on existing drivers and
152applications. -->
153
154      <revision>
155	<revnumber>3.17</revnumber>
156	<date>2014-08-04</date>
157	<authorinitials>lp, hv</authorinitials>
158	<revremark>Extended &v4l2-pix-format;. Added format flags. Added compound control types
159and VIDIOC_QUERY_EXT_CTRL.
160	</revremark>
161      </revision>
162
163      <revision>
164	<revnumber>3.15</revnumber>
165	<date>2014-02-03</date>
166	<authorinitials>hv, ap</authorinitials>
167	<revremark>Update several sections of "Common API Elements": "Opening and Closing Devices"
168"Querying Capabilities", "Application Priority", "Video Inputs and Outputs", "Audio Inputs and Outputs"
169"Tuners and Modulators", "Video Standards" and "Digital Video (DV) Timings". Added SDR API.
170	</revremark>
171      </revision>
172
173      <revision>
174	<revnumber>3.14</revnumber>
175	<date>2013-11-25</date>
176	<authorinitials>rr</authorinitials>
177	<revremark>Set width and height as unsigned on v4l2_rect.
178	</revremark>
179      </revision>
180
181      <revision>
182	<revnumber>3.11</revnumber>
183	<date>2013-05-26</date>
184	<authorinitials>hv</authorinitials>
185	<revremark>Remove obsolete VIDIOC_DBG_G_CHIP_IDENT ioctl.
186	</revremark>
187      </revision>
188
189      <revision>
190	<revnumber>3.10</revnumber>
191	<date>2013-03-25</date>
192	<authorinitials>hv</authorinitials>
193	<revremark>Remove obsolete and unused DV_PRESET ioctls:
194	VIDIOC_G_DV_PRESET, VIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and
195	VIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output capability
196	flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS. Added VIDIOC_DBG_G_CHIP_INFO.
197	</revremark>
198      </revision>
199
200      <revision>
201	<revnumber>3.9</revnumber>
202	<date>2012-12-03</date>
203	<authorinitials>sa, sn</authorinitials>
204	<revremark>Added timestamp types to v4l2_buffer.
205	Added V4L2_EVENT_CTRL_CH_RANGE control event changes flag.
206	</revremark>
207      </revision>
208
209      <revision>
210	<revnumber>3.6</revnumber>
211	<date>2012-07-02</date>
212	<authorinitials>hv</authorinitials>
213	<revremark>Added VIDIOC_ENUM_FREQ_BANDS.
214	</revremark>
215      </revision>
216
217      <revision>
218	<revnumber>3.5</revnumber>
219	<date>2012-05-07</date>
220	<authorinitials>sa, sn, hv</authorinitials>
221	<revremark>Added V4L2_CTRL_TYPE_INTEGER_MENU and V4L2 subdev
222	    selections API. Improved the description of V4L2_CID_COLORFX
223	    control, added V4L2_CID_COLORFX_CBCR control.
224	    Added camera controls V4L2_CID_AUTO_EXPOSURE_BIAS,
225	    V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE, V4L2_CID_IMAGE_STABILIZATION,
226	    V4L2_CID_ISO_SENSITIVITY, V4L2_CID_ISO_SENSITIVITY_AUTO,
227	    V4L2_CID_EXPOSURE_METERING, V4L2_CID_SCENE_MODE,
228	    V4L2_CID_3A_LOCK, V4L2_CID_AUTO_FOCUS_START,
229	    V4L2_CID_AUTO_FOCUS_STOP, V4L2_CID_AUTO_FOCUS_STATUS
230	    and V4L2_CID_AUTO_FOCUS_RANGE.
231	    Added VIDIOC_ENUM_DV_TIMINGS, VIDIOC_QUERY_DV_TIMINGS and
232	    VIDIOC_DV_TIMINGS_CAP.
233	</revremark>
234      </revision>
235
236      <revision>
237	<revnumber>3.4</revnumber>
238	<date>2012-01-25</date>
239	<authorinitials>sn</authorinitials>
240	<revremark>Added <link linkend="jpeg-controls">JPEG compression
241	    control class.</link>
242	</revremark>
243      </revision>
244
245      <revision>
246	<revnumber>3.3</revnumber>
247	<date>2012-01-11</date>
248	<authorinitials>hv</authorinitials>
249	<revremark>Added device_caps field to struct v4l2_capabilities.</revremark>
250      </revision>
251
252      <revision>
253	<revnumber>3.2</revnumber>
254	<date>2011-08-26</date>
255	<authorinitials>hv</authorinitials>
256	<revremark>Added V4L2_CTRL_FLAG_VOLATILE.</revremark>
257      </revision>
258
259      <revision>
260	<revnumber>3.1</revnumber>
261	<date>2011-06-27</date>
262	<authorinitials>mcc, po, hv</authorinitials>
263	<revremark>Documented that VIDIOC_QUERYCAP now returns a per-subsystem version instead of a per-driver one.
264		   Standardize an error code for invalid ioctl.
265		   Added V4L2_CTRL_TYPE_BITMASK.</revremark>
266      </revision>
267
268      <revision>
269	<revnumber>2.6.39</revnumber>
270	<date>2011-03-01</date>
271	<authorinitials>mcc, po</authorinitials>
272	<revremark>Removed VIDIOC_*_OLD from videodev2.h header and update it to reflect latest changes. Added the <link linkend="planar-apis">multi-planar API</link>.</revremark>
273      </revision>
274
275      <revision>
276	<revnumber>2.6.37</revnumber>
277	<date>2010-08-06</date>
278	<authorinitials>hv</authorinitials>
279	<revremark>Removed obsolete vtx (videotext) API.</revremark>
280      </revision>
281
282      <revision>
283	<revnumber>2.6.33</revnumber>
284	<date>2009-12-03</date>
285	<authorinitials>mk</authorinitials>
286	<revremark>Added documentation for the Digital Video timings API.</revremark>
287      </revision>
288
289      <revision>
290	<revnumber>2.6.32</revnumber>
291	<date>2009-08-31</date>
292	<authorinitials>mcc</authorinitials>
293	<revremark>Now, revisions will match the kernel version where
294the V4L2 API changes will be used by the Linux Kernel.
295Also added Remote Controller chapter.</revremark>
296      </revision>
297
298      <revision>
299	<revnumber>0.29</revnumber>
300	<date>2009-08-26</date>
301	<authorinitials>ev</authorinitials>
302	<revremark>Added documentation for string controls and for FM Transmitter controls.</revremark>
303      </revision>
304
305      <revision>
306	<revnumber>0.28</revnumber>
307	<date>2009-08-26</date>
308	<authorinitials>gl</authorinitials>
309	<revremark>Added V4L2_CID_BAND_STOP_FILTER documentation.</revremark>
310      </revision>
311
312      <revision>
313	<revnumber>0.27</revnumber>
314	<date>2009-08-15</date>
315	<authorinitials>mcc</authorinitials>
316	<revremark>Added libv4l and Remote Controller documentation;
317added v4l2grab and keytable application examples.</revremark>
318      </revision>
319
320      <revision>
321	<revnumber>0.26</revnumber>
322	<date>2009-07-23</date>
323	<authorinitials>hv</authorinitials>
324	<revremark>Finalized the RDS capture API. Added modulator and RDS encoder
325capabilities. Added support for string controls.</revremark>
326      </revision>
327
328      <revision>
329	<revnumber>0.25</revnumber>
330	<date>2009-01-18</date>
331	<authorinitials>hv</authorinitials>
332	<revremark>Added pixel formats VYUY, NV16 and NV61, and changed
333the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT.
334Added camera controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE,
335V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY.</revremark>
336      </revision>
337
338      <revision>
339	<revnumber>0.24</revnumber>
340	<date>2008-03-04</date>
341	<authorinitials>mhs</authorinitials>
342	<revremark>Added pixel formats Y16 and SBGGR16, new controls
343and a camera controls class. Removed VIDIOC_G/S_MPEGCOMP.</revremark>
344      </revision>
345
346      <revision>
347	<revnumber>0.23</revnumber>
348	<date>2007-08-30</date>
349	<authorinitials>mhs</authorinitials>
350	<revremark>Fixed a typo in VIDIOC_DBG_G/S_REGISTER.
351Clarified the byte order of packed pixel formats.</revremark>
352      </revision>
353
354      <revision>
355	<revnumber>0.22</revnumber>
356	<date>2007-08-29</date>
357	<authorinitials>mhs</authorinitials>
358	<revremark>Added the Video Output Overlay interface, new MPEG
359controls, V4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT,
360VIDIOC_DBG_G/S_REGISTER, VIDIOC_(TRY_)ENCODER_CMD,
361VIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats.
362Clarifications in the cropping chapter, about RGB pixel formats, the
363mmap(), poll(), select(), read() and write() functions. Typographical
364fixes.</revremark>
365      </revision>
366
367      <revision>
368	<revnumber>0.21</revnumber>
369	<date>2006-12-19</date>
370	<authorinitials>mhs</authorinitials>
371	<revremark>Fixed a link in the VIDIOC_G_EXT_CTRLS section.</revremark>
372      </revision>
373
374      <revision>
375	<revnumber>0.20</revnumber>
376	<date>2006-11-24</date>
377	<authorinitials>mhs</authorinitials>
378	<revremark>Clarified the purpose of the audioset field in
379struct v4l2_input and v4l2_output.</revremark>
380      </revision>
381
382      <revision>
383	<revnumber>0.19</revnumber>
384	<date>2006-10-19</date>
385	<authorinitials>mhs</authorinitials>
386	<revremark>Documented V4L2_PIX_FMT_RGB444.</revremark>
387      </revision>
388
389      <revision>
390	<revnumber>0.18</revnumber>
391	<date>2006-10-18</date>
392	<authorinitials>mhs</authorinitials>
393	<revremark>Added the description of extended controls by Hans
394Verkuil. Linked V4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE.</revremark>
395      </revision>
396
397      <revision>
398	<revnumber>0.17</revnumber>
399	<date>2006-10-12</date>
400	<authorinitials>mhs</authorinitials>
401	<revremark>Corrected V4L2_PIX_FMT_HM12 description.</revremark>
402      </revision>
403
404      <revision>
405	<revnumber>0.16</revnumber>
406	<date>2006-10-08</date>
407	<authorinitials>mhs</authorinitials>
408	<revremark>VIDIOC_ENUM_FRAMESIZES and
409VIDIOC_ENUM_FRAMEINTERVALS are now part of the API.</revremark>
410      </revision>
411
412      <revision>
413	<revnumber>0.15</revnumber>
414	<date>2006-09-23</date>
415	<authorinitials>mhs</authorinitials>
416	<revremark>Cleaned up the bibliography, added BT.653 and
417BT.1119. capture.c/start_capturing() for user pointer I/O did not
418initialize the buffer index. Documented the V4L MPEG and MJPEG
419VID_TYPEs and V4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel
420formats. See the history chapter for API changes.</revremark>
421      </revision>
422
423      <revision>
424	<revnumber>0.14</revnumber>
425	<date>2006-09-14</date>
426	<authorinitials>mr</authorinitials>
427	<revremark>Added VIDIOC_ENUM_FRAMESIZES and
428VIDIOC_ENUM_FRAMEINTERVALS proposal for frame format enumeration of
429digital devices.</revremark>
430      </revision>
431
432      <revision>
433	<revnumber>0.13</revnumber>
434	<date>2006-04-07</date>
435	<authorinitials>mhs</authorinitials>
436	<revremark>Corrected the description of struct v4l2_window
437clips. New V4L2_STD_ and V4L2_TUNER_MODE_LANG1_LANG2
438defines.</revremark>
439      </revision>
440
441      <revision>
442	<revnumber>0.12</revnumber>
443	<date>2006-02-03</date>
444	<authorinitials>mhs</authorinitials>
445	<revremark>Corrected the description of struct
446v4l2_captureparm and v4l2_outputparm.</revremark>
447      </revision>
448
449      <revision>
450	<revnumber>0.11</revnumber>
451	<date>2006-01-27</date>
452	<authorinitials>mhs</authorinitials>
453	<revremark>Improved the description of struct
454v4l2_tuner.</revremark>
455      </revision>
456
457      <revision>
458	<revnumber>0.10</revnumber>
459	<date>2006-01-10</date>
460	<authorinitials>mhs</authorinitials>
461	<revremark>VIDIOC_G_INPUT and VIDIOC_S_PARM
462clarifications.</revremark>
463      </revision>
464
465      <revision>
466	<revnumber>0.9</revnumber>
467	<date>2005-11-27</date>
468	<authorinitials>mhs</authorinitials>
469	<revremark>Improved the 525 line numbering diagram. Hans
470Verkuil and I rewrote the sliced VBI section. He also contributed a
471VIDIOC_LOG_STATUS page. Fixed VIDIOC_S_STD call in the video standard
472selection example. Various updates.</revremark>
473      </revision>
474
475      <revision>
476	<revnumber>0.8</revnumber>
477	<date>2004-10-04</date>
478	<authorinitials>mhs</authorinitials>
479	<revremark>Somehow a piece of junk slipped into the capture
480example, removed.</revremark>
481      </revision>
482
483      <revision>
484	<revnumber>0.7</revnumber>
485	<date>2004-09-19</date>
486	<authorinitials>mhs</authorinitials>
487	<revremark>Fixed video standard selection, control
488enumeration, downscaling and aspect example. Added read and user
489pointer i/o to video capture example.</revremark>
490      </revision>
491
492      <revision>
493	<revnumber>0.6</revnumber>
494	<date>2004-08-01</date>
495	<authorinitials>mhs</authorinitials>
496	<revremark>v4l2_buffer changes, added video capture example,
497various corrections.</revremark>
498      </revision>
499
500      <revision>
501	<revnumber>0.5</revnumber>
502	<date>2003-11-05</date>
503	<authorinitials>mhs</authorinitials>
504	<revremark>Pixel format erratum.</revremark>
505      </revision>
506
507      <revision>
508	<revnumber>0.4</revnumber>
509	<date>2003-09-17</date>
510	<authorinitials>mhs</authorinitials>
511	<revremark>Corrected source and Makefile to generate a PDF.
512SGML fixes. Added latest API changes. Closed gaps in the history
513chapter.</revremark>
514      </revision>
515
516      <revision>
517	<revnumber>0.3</revnumber>
518	<date>2003-02-05</date>
519	<authorinitials>mhs</authorinitials>
520	<revremark>Another draft, more corrections.</revremark>
521      </revision>
522
523      <revision>
524	<revnumber>0.2</revnumber>
525	<date>2003-01-15</date>
526	<authorinitials>mhs</authorinitials>
527	<revremark>Second draft, with corrections pointed out by Gerd
528Knorr.</revremark>
529      </revision>
530
531      <revision>
532	<revnumber>0.1</revnumber>
533	<date>2002-12-01</date>
534	<authorinitials>mhs</authorinitials>
535	<revremark>First draft, based on documentation by Bill Dirks
536and discussions on the V4L mailing list.</revremark>
537      </revision>
538    </revhistory>
539</partinfo>
540
541<title>Video for Linux Two API Specification</title>
542 <subtitle>Revision 3.17</subtitle>
543
544  <chapter id="common">
545    &sub-common;
546  </chapter>
547
548  <chapter id="pixfmt">
549    &sub-pixfmt;
550  </chapter>
551
552  <chapter id="io">
553    &sub-io;
554  </chapter>
555
556  <chapter id="devices">
557    <title>Interfaces</title>
558
559    <section id="capture"> &sub-dev-capture; </section>
560    <section id="overlay"> &sub-dev-overlay; </section>
561    <section id="output"> &sub-dev-output; </section>
562    <section id="osd"> &sub-dev-osd; </section>
563    <section id="codec"> &sub-dev-codec; </section>
564    <section id="effect"> &sub-dev-effect; </section>
565    <section id="raw-vbi"> &sub-dev-raw-vbi; </section>
566    <section id="sliced"> &sub-dev-sliced-vbi; </section>
567    <section id="ttx"> &sub-dev-teletext; </section>
568    <section id="radio"> &sub-dev-radio; </section>
569    <section id="rds"> &sub-dev-rds; </section>
570    <section id="sdr"> &sub-dev-sdr; </section>
571    <section id="event"> &sub-dev-event; </section>
572    <section id="subdev"> &sub-dev-subdev; </section>
573  </chapter>
574
575  <chapter id="driver">
576	  &sub-driver;
577  </chapter>
578
579  <chapter id="libv4l">
580	  &sub-libv4l;
581  </chapter>
582
583  <chapter id="compat">
584	  &sub-compat;
585  </chapter>
586
587  <appendix id="user-func">
588  <title>Function Reference</title>
589
590    <!-- Keep this alphabetically sorted. -->
591
592    &sub-close;
593    &sub-ioctl;
594    <!-- All ioctls go here. -->
595    &sub-create-bufs;
596    &sub-cropcap;
597    &sub-dbg-g-chip-info;
598    &sub-dbg-g-register;
599    &sub-decoder-cmd;
600    &sub-dqevent;
601    &sub-dv-timings-cap;
602    &sub-encoder-cmd;
603    &sub-enumaudio;
604    &sub-enumaudioout;
605    &sub-enum-dv-timings;
606    &sub-enum-fmt;
607    &sub-enum-framesizes;
608    &sub-enum-frameintervals;
609    &sub-enum-freq-bands;
610    &sub-enuminput;
611    &sub-enumoutput;
612    &sub-enumstd;
613    &sub-expbuf;
614    &sub-g-audio;
615    &sub-g-audioout;
616    &sub-g-crop;
617    &sub-g-ctrl;
618    &sub-g-dv-timings;
619    &sub-g-edid;
620    &sub-g-enc-index;
621    &sub-g-ext-ctrls;
622    &sub-g-fbuf;
623    &sub-g-fmt;
624    &sub-g-frequency;
625    &sub-g-input;
626    &sub-g-jpegcomp;
627    &sub-g-modulator;
628    &sub-g-output;
629    &sub-g-parm;
630    &sub-g-priority;
631    &sub-g-selection;
632    &sub-g-sliced-vbi-cap;
633    &sub-g-std;
634    &sub-g-tuner;
635    &sub-log-status;
636    &sub-overlay;
637    &sub-prepare-buf;
638    &sub-qbuf;
639    &sub-querybuf;
640    &sub-querycap;
641    &sub-queryctrl;
642    &sub-query-dv-timings;
643    &sub-querystd;
644    &sub-reqbufs;
645    &sub-s-hw-freq-seek;
646    &sub-streamon;
647    &sub-subdev-enum-frame-interval;
648    &sub-subdev-enum-frame-size;
649    &sub-subdev-enum-mbus-code;
650    &sub-subdev-g-crop;
651    &sub-subdev-g-fmt;
652    &sub-subdev-g-frame-interval;
653    &sub-subdev-g-selection;
654    &sub-subscribe-event;
655    <!-- End of ioctls. -->
656    &sub-mmap;
657    &sub-munmap;
658    &sub-open;
659    &sub-poll;
660    &sub-read;
661    &sub-select;
662    &sub-write;
663  </appendix>
664
665  <appendix>
666    <title>Common definitions for V4L2 and V4L2 subdev interfaces</title>
667      &sub-selections-common;
668  </appendix>
669
670  <appendix id="videodev">
671    <title>Video For Linux Two Header File</title>
672    &sub-videodev2-h;
673  </appendix>
674
675  <appendix id="capture-example">
676    <title>Video Capture Example</title>
677    &sub-capture-c;
678  </appendix>
679
680  <appendix id="v4l2grab-example">
681    <title>Video Grabber example using libv4l</title>
682    <para>This program demonstrates how to grab V4L2 images in ppm format by
683using libv4l handlers. The advantage is that this grabber can potentially work
684with any V4L2 driver.</para>
685    &sub-v4l2grab-c;
686  </appendix>
687
688  &sub-media-indices;
689
690  &sub-biblio;
691
692