[mirror_ubuntu-bionic-kernel.git] / Documentation / DocBook / media / v4l / v4l2.xml

 <partinfo>
    <authorgroup>
      <author>
	<firstname>Michael</firstname>
	<surname>Schimek</surname>
	<othername role="mi">H</othername>
	<affiliation>
	  <address>
	    <email>mschimek@gmx.at</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Bill</firstname>
	<surname>Dirks</surname>
	<!-- Commented until Bill opts in to be spammed.
	<affiliation>
	  <address>
	    <email>bill@thedirks.org</email>
	  </address>
	</affiliation> -->
	<contrib>Original author of the V4L2 API and
documentation.</contrib>
      </author>

      <author>
	<firstname>Hans</firstname>
	<surname>Verkuil</surname>
	<contrib>Designed and documented the VIDIOC_LOG_STATUS ioctl,
the extended control ioctls, major parts of the sliced VBI API, the
MPEG encoder and decoder APIs and the DV Timings API.</contrib>
	<affiliation>
	  <address>
	    <email>hverkuil@xs4all.nl</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Martin</firstname>
	<surname>Rubli</surname>
	<!--
	<affiliation>
	  <address>
	    <email>martin_rubli@logitech.com</email>
	  </address>
	</affiliation> -->
	<contrib>Designed and documented the VIDIOC_ENUM_FRAMESIZES
and VIDIOC_ENUM_FRAMEINTERVALS ioctls.</contrib>
      </author>

      <author>
	<firstname>Andy</firstname>
	<surname>Walls</surname>
	<contrib>Documented the fielded V4L2_MPEG_STREAM_VBI_FMT_IVTV
MPEG stream embedded, sliced VBI data format in this specification.
</contrib>
	<affiliation>
	  <address>
	    <email>awalls@md.metrocast.net</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Mauro</firstname>
	<surname>Carvalho Chehab</surname>
	<contrib>Documented libv4l, designed and added v4l2grab example,
Remote Controller chapter.</contrib>
	<affiliation>
	  <address>
	    <email>m.chehab@samsung.com</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Muralidharan</firstname>
	<surname>Karicheri</surname>
	<contrib>Documented the Digital Video timings API.</contrib>
	<affiliation>
	  <address>
	    <email>m-karicheri2@ti.com</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Pawel</firstname>
	<surname>Osciak</surname>
	<contrib>Designed and documented the multi-planar API.</contrib>
	<affiliation>
	  <address>
	    <email>pawel AT osciak.com</email>
	  </address>
	</affiliation>
      </author>

      <author>
	<firstname>Sakari</firstname>
	<surname>Ailus</surname>
	<contrib>Subdev selections API.</contrib>
	<affiliation>
	  <address>
	    <email>sakari.ailus@iki.fi</email>
	  </address>
	</affiliation>
      </author>
    </authorgroup>

    <copyright>
      <year>1999</year>
      <year>2000</year>
      <year>2001</year>
      <year>2002</year>
      <year>2003</year>
      <year>2004</year>
      <year>2005</year>
      <year>2006</year>
      <year>2007</year>
      <year>2008</year>
      <year>2009</year>
      <year>2010</year>
      <year>2011</year>
      <year>2012</year>
      <year>2013</year>
      <year>2014</year>
      <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
Rubli, Andy Walls, Muralidharan Karicheri, Mauro Carvalho Chehab,
	Pawel Osciak</holder>
    </copyright>
    <legalnotice>
    <para>Except when explicitly stated as GPL, programming examples within
	    this part can be used and distributed without restrictions.</para>
    </legalnotice>
    <revhistory>
      <!-- Put document revisions here, newest first. -->
      <!-- API revisions (changes and additions of defines, enums,
structs, ioctls) must be noted in more detail in the history chapter
(compat.xml), along with the possible impact on existing drivers and
applications. -->

      <revision>
	<revnumber>3.14</revnumber>
	<date>2013-11-25</date>
	<authorinitials>rr</authorinitials>
	<revremark>Set width and height as unsigned on v4l2_rect.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.11</revnumber>
	<date>2013-05-26</date>
	<authorinitials>hv</authorinitials>
	<revremark>Remove obsolete VIDIOC_DBG_G_CHIP_IDENT ioctl.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.10</revnumber>
	<date>2013-03-25</date>
	<authorinitials>hv</authorinitials>
	<revremark>Remove obsolete and unused DV_PRESET ioctls:
	VIDIOC_G_DV_PRESET, VIDIOC_S_DV_PRESET, VIDIOC_QUERY_DV_PRESET and
	VIDIOC_ENUM_DV_PRESET. Remove the related v4l2_input/output capability
	flags V4L2_IN_CAP_PRESETS and V4L2_OUT_CAP_PRESETS. Added VIDIOC_DBG_G_CHIP_INFO.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.9</revnumber>
	<date>2012-12-03</date>
	<authorinitials>sa, sn</authorinitials>
	<revremark>Added timestamp types to v4l2_buffer.
	Added V4L2_EVENT_CTRL_CH_RANGE control event changes flag.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.6</revnumber>
	<date>2012-07-02</date>
	<authorinitials>hv</authorinitials>
	<revremark>Added VIDIOC_ENUM_FREQ_BANDS.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.5</revnumber>
	<date>2012-05-07</date>
	<authorinitials>sa, sn, hv</authorinitials>
	<revremark>Added V4L2_CTRL_TYPE_INTEGER_MENU and V4L2 subdev
	    selections API. Improved the description of V4L2_CID_COLORFX
	    control, added V4L2_CID_COLORFX_CBCR control.
	    Added camera controls V4L2_CID_AUTO_EXPOSURE_BIAS,
	    V4L2_CID_AUTO_N_PRESET_WHITE_BALANCE, V4L2_CID_IMAGE_STABILIZATION,
	    V4L2_CID_ISO_SENSITIVITY, V4L2_CID_ISO_SENSITIVITY_AUTO,
	    V4L2_CID_EXPOSURE_METERING, V4L2_CID_SCENE_MODE,
	    V4L2_CID_3A_LOCK, V4L2_CID_AUTO_FOCUS_START,
	    V4L2_CID_AUTO_FOCUS_STOP, V4L2_CID_AUTO_FOCUS_STATUS
	    and V4L2_CID_AUTO_FOCUS_RANGE.
	    Added VIDIOC_ENUM_DV_TIMINGS, VIDIOC_QUERY_DV_TIMINGS and
	    VIDIOC_DV_TIMINGS_CAP.
	</revremark>
      </revision>

      <revision>
	<revnumber>3.4</revnumber>
	<date>2012-01-25</date>
	<authorinitials>sn</authorinitials>
	<revremark>Added <link linkend="jpeg-controls">JPEG compression
	    control class.</link>
	</revremark>
      </revision>

      <revision>
	<revnumber>3.3</revnumber>
	<date>2012-01-11</date>
	<authorinitials>hv</authorinitials>
	<revremark>Added device_caps field to struct v4l2_capabilities.</revremark>
      </revision>

      <revision>
	<revnumber>3.2</revnumber>
	<date>2011-08-26</date>
	<authorinitials>hv</authorinitials>
	<revremark>Added V4L2_CTRL_FLAG_VOLATILE.</revremark>
      </revision>

      <revision>
	<revnumber>3.1</revnumber>
	<date>2011-06-27</date>
	<authorinitials>mcc, po, hv</authorinitials>
	<revremark>Documented that VIDIOC_QUERYCAP now returns a per-subsystem version instead of a per-driver one.
		   Standardize an error code for invalid ioctl.
		   Added V4L2_CTRL_TYPE_BITMASK.</revremark>
      </revision>

      <revision>
	<revnumber>2.6.39</revnumber>
	<date>2011-03-01</date>
	<authorinitials>mcc, po</authorinitials>
	<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>
      </revision>

      <revision>
	<revnumber>2.6.37</revnumber>
	<date>2010-08-06</date>
	<authorinitials>hv</authorinitials>
	<revremark>Removed obsolete vtx (videotext) API.</revremark>
      </revision>

      <revision>
	<revnumber>2.6.33</revnumber>
	<date>2009-12-03</date>
	<authorinitials>mk</authorinitials>
	<revremark>Added documentation for the Digital Video timings API.</revremark>
      </revision>

      <revision>
	<revnumber>2.6.32</revnumber>
	<date>2009-08-31</date>
	<authorinitials>mcc</authorinitials>
	<revremark>Now, revisions will match the kernel version where
the V4L2 API changes will be used by the Linux Kernel.
Also added Remote Controller chapter.</revremark>
      </revision>

      <revision>
	<revnumber>0.29</revnumber>
	<date>2009-08-26</date>
	<authorinitials>ev</authorinitials>
	<revremark>Added documentation for string controls and for FM Transmitter controls.</revremark>
      </revision>

      <revision>
	<revnumber>0.28</revnumber>
	<date>2009-08-26</date>
	<authorinitials>gl</authorinitials>
	<revremark>Added V4L2_CID_BAND_STOP_FILTER documentation.</revremark>
      </revision>

      <revision>
	<revnumber>0.27</revnumber>
	<date>2009-08-15</date>
	<authorinitials>mcc</authorinitials>
	<revremark>Added libv4l and Remote Controller documentation;
added v4l2grab and keytable application examples.</revremark>
      </revision>

      <revision>
	<revnumber>0.26</revnumber>
	<date>2009-07-23</date>
	<authorinitials>hv</authorinitials>
	<revremark>Finalized the RDS capture API. Added modulator and RDS encoder
capabilities. Added support for string controls.</revremark>
      </revision>

      <revision>
	<revnumber>0.25</revnumber>
	<date>2009-01-18</date>
	<authorinitials>hv</authorinitials>
	<revremark>Added pixel formats VYUY, NV16 and NV61, and changed
the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT.
Added camera controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE,
V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY.</revremark>
      </revision>

      <revision>
	<revnumber>0.24</revnumber>
	<date>2008-03-04</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Added pixel formats Y16 and SBGGR16, new controls
and a camera controls class. Removed VIDIOC_G/S_MPEGCOMP.</revremark>
      </revision>

      <revision>
	<revnumber>0.23</revnumber>
	<date>2007-08-30</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Fixed a typo in VIDIOC_DBG_G/S_REGISTER.
Clarified the byte order of packed pixel formats.</revremark>
      </revision>

      <revision>
	<revnumber>0.22</revnumber>
	<date>2007-08-29</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Added the Video Output Overlay interface, new MPEG
controls, V4L2_FIELD_INTERLACED_TB and V4L2_FIELD_INTERLACED_BT,
VIDIOC_DBG_G/S_REGISTER, VIDIOC_(TRY_)ENCODER_CMD,
VIDIOC_G_CHIP_IDENT, VIDIOC_G_ENC_INDEX, new pixel formats.
Clarifications in the cropping chapter, about RGB pixel formats, the
mmap(), poll(), select(), read() and write() functions. Typographical
fixes.</revremark>
      </revision>

      <revision>
	<revnumber>0.21</revnumber>
	<date>2006-12-19</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Fixed a link in the VIDIOC_G_EXT_CTRLS section.</revremark>
      </revision>

      <revision>
	<revnumber>0.20</revnumber>
	<date>2006-11-24</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Clarified the purpose of the audioset field in
struct v4l2_input and v4l2_output.</revremark>
      </revision>

      <revision>
	<revnumber>0.19</revnumber>
	<date>2006-10-19</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Documented V4L2_PIX_FMT_RGB444.</revremark>
      </revision>

      <revision>
	<revnumber>0.18</revnumber>
	<date>2006-10-18</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Added the description of extended controls by Hans
Verkuil. Linked V4L2_PIX_FMT_MPEG to V4L2_CID_MPEG_STREAM_TYPE.</revremark>
      </revision>

      <revision>
	<revnumber>0.17</revnumber>
	<date>2006-10-12</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Corrected V4L2_PIX_FMT_HM12 description.</revremark>
      </revision>

      <revision>
	<revnumber>0.16</revnumber>
	<date>2006-10-08</date>
	<authorinitials>mhs</authorinitials>
	<revremark>VIDIOC_ENUM_FRAMESIZES and
VIDIOC_ENUM_FRAMEINTERVALS are now part of the API.</revremark>
      </revision>

      <revision>
	<revnumber>0.15</revnumber>
	<date>2006-09-23</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Cleaned up the bibliography, added BT.653 and
BT.1119. capture.c/start_capturing() for user pointer I/O did not
initialize the buffer index. Documented the V4L MPEG and MJPEG
VID_TYPEs and V4L2_PIX_FMT_SBGGR8. Updated the list of reserved pixel
formats. See the history chapter for API changes.</revremark>
      </revision>

      <revision>
	<revnumber>0.14</revnumber>
	<date>2006-09-14</date>
	<authorinitials>mr</authorinitials>
	<revremark>Added VIDIOC_ENUM_FRAMESIZES and
VIDIOC_ENUM_FRAMEINTERVALS proposal for frame format enumeration of
digital devices.</revremark>
      </revision>

      <revision>
	<revnumber>0.13</revnumber>
	<date>2006-04-07</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Corrected the description of struct v4l2_window
clips. New V4L2_STD_ and V4L2_TUNER_MODE_LANG1_LANG2
defines.</revremark>
      </revision>

      <revision>
	<revnumber>0.12</revnumber>
	<date>2006-02-03</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Corrected the description of struct
v4l2_captureparm and v4l2_outputparm.</revremark>
      </revision>

      <revision>
	<revnumber>0.11</revnumber>
	<date>2006-01-27</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Improved the description of struct
v4l2_tuner.</revremark>
      </revision>

      <revision>
	<revnumber>0.10</revnumber>
	<date>2006-01-10</date>
	<authorinitials>mhs</authorinitials>
	<revremark>VIDIOC_G_INPUT and VIDIOC_S_PARM
clarifications.</revremark>
      </revision>

      <revision>
	<revnumber>0.9</revnumber>
	<date>2005-11-27</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Improved the 525 line numbering diagram. Hans
Verkuil and I rewrote the sliced VBI section. He also contributed a
VIDIOC_LOG_STATUS page. Fixed VIDIOC_S_STD call in the video standard
selection example. Various updates.</revremark>
      </revision>

      <revision>
	<revnumber>0.8</revnumber>
	<date>2004-10-04</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Somehow a piece of junk slipped into the capture
example, removed.</revremark>
      </revision>

      <revision>
	<revnumber>0.7</revnumber>
	<date>2004-09-19</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Fixed video standard selection, control
enumeration, downscaling and aspect example. Added read and user
pointer i/o to video capture example.</revremark>
      </revision>

      <revision>
	<revnumber>0.6</revnumber>
	<date>2004-08-01</date>
	<authorinitials>mhs</authorinitials>
	<revremark>v4l2_buffer changes, added video capture example,
various corrections.</revremark>
      </revision>

      <revision>
	<revnumber>0.5</revnumber>
	<date>2003-11-05</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Pixel format erratum.</revremark>
      </revision>

      <revision>
	<revnumber>0.4</revnumber>
	<date>2003-09-17</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Corrected source and Makefile to generate a PDF.
SGML fixes. Added latest API changes. Closed gaps in the history
chapter.</revremark>
      </revision>

      <revision>
	<revnumber>0.3</revnumber>
	<date>2003-02-05</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Another draft, more corrections.</revremark>
      </revision>

      <revision>
	<revnumber>0.2</revnumber>
	<date>2003-01-15</date>
	<authorinitials>mhs</authorinitials>
	<revremark>Second draft, with corrections pointed out by Gerd
Knorr.</revremark>
      </revision>

      <revision>
	<revnumber>0.1</revnumber>
	<date>2002-12-01</date>
	<authorinitials>mhs</authorinitials>
	<revremark>First draft, based on documentation by Bill Dirks
and discussions on the V4L mailing list.</revremark>
      </revision>
    </revhistory>
</partinfo>

<title>Video for Linux Two API Specification</title>
 <subtitle>Revision 3.14</subtitle>

  <chapter id="common">
    &sub-common;
  </chapter>

  <chapter id="pixfmt">
    &sub-pixfmt;
  </chapter>

  <chapter id="io">
    &sub-io;
  </chapter>

  <chapter id="devices">
    <title>Interfaces</title>

    <section id="capture"> &sub-dev-capture; </section>
    <section id="overlay"> &sub-dev-overlay; </section>
    <section id="output"> &sub-dev-output; </section>
    <section id="osd"> &sub-dev-osd; </section>
    <section id="codec"> &sub-dev-codec; </section>
    <section id="effect"> &sub-dev-effect; </section>
    <section id="raw-vbi"> &sub-dev-raw-vbi; </section>
    <section id="sliced"> &sub-dev-sliced-vbi; </section>
    <section id="ttx"> &sub-dev-teletext; </section>
    <section id="radio"> &sub-dev-radio; </section>
    <section id="rds"> &sub-dev-rds; </section>
    <section id="event"> &sub-dev-event; </section>
    <section id="subdev"> &sub-dev-subdev; </section>
  </chapter>

  <chapter id="driver">
	  &sub-driver;
  </chapter>

  <chapter id="libv4l">
	  &sub-libv4l;
  </chapter>

  <chapter id="compat">
	  &sub-compat;
  </chapter>

  <appendix id="user-func">
  <title>Function Reference</title>

    <!-- Keep this alphabetically sorted. -->

    &sub-close;
    &sub-ioctl;
    <!-- All ioctls go here. -->
    &sub-create-bufs;
    &sub-cropcap;
    &sub-dbg-g-chip-info;
    &sub-dbg-g-register;
    &sub-decoder-cmd;
    &sub-dqevent;
    &sub-dv-timings-cap;
    &sub-encoder-cmd;
    &sub-enumaudio;
    &sub-enumaudioout;
    &sub-enum-dv-timings;
    &sub-enum-fmt;
    &sub-enum-framesizes;
    &sub-enum-frameintervals;
    &sub-enum-freq-bands;
    &sub-enuminput;
    &sub-enumoutput;
    &sub-enumstd;
    &sub-expbuf;
    &sub-g-audio;
    &sub-g-audioout;
    &sub-g-crop;
    &sub-g-ctrl;
    &sub-g-dv-timings;
    &sub-g-enc-index;
    &sub-g-ext-ctrls;
    &sub-g-fbuf;
    &sub-g-fmt;
    &sub-g-frequency;
    &sub-g-input;
    &sub-g-jpegcomp;
    &sub-g-modulator;
    &sub-g-output;
    &sub-g-parm;
    &sub-g-priority;
    &sub-g-selection;
    &sub-g-sliced-vbi-cap;
    &sub-g-std;
    &sub-g-tuner;
    &sub-log-status;
    &sub-overlay;
    &sub-prepare-buf;
    &sub-qbuf;
    &sub-querybuf;
    &sub-querycap;
    &sub-queryctrl;
    &sub-query-dv-timings;
    &sub-querystd;
    &sub-reqbufs;
    &sub-s-hw-freq-seek;
    &sub-streamon;
    &sub-subdev-enum-frame-interval;
    &sub-subdev-enum-frame-size;
    &sub-subdev-enum-mbus-code;
    &sub-subdev-g-crop;
    &sub-subdev-g-edid;
    &sub-subdev-g-fmt;
    &sub-subdev-g-frame-interval;
    &sub-subdev-g-selection;
    &sub-subscribe-event;
    <!-- End of ioctls. -->
    &sub-mmap;
    &sub-munmap;
    &sub-open;
    &sub-poll;
    &sub-read;
    &sub-select;
    &sub-write;
  </appendix>

  <appendix>
    <title>Common definitions for V4L2 and V4L2 subdev interfaces</title>
      &sub-selections-common;
  </appendix>

  <appendix id="videodev">
    <title>Video For Linux Two Header File</title>
    &sub-videodev2-h;
  </appendix>

  <appendix id="capture-example">
    <title>Video Capture Example</title>
    &sub-capture-c;
  </appendix>

  <appendix id="v4l2grab-example">
    <title>Video Grabber example using libv4l</title>
    <para>This program demonstrates how to grab V4L2 images in ppm format by
using libv4l handlers. The advantage is that this grabber can potentially work
with any V4L2 driver.</para>
    &sub-v4l2grab-c;
  </appendix>

  &sub-media-indices;

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