summaryrefslogtreecommitdiff
path: root/staging-specs/media.xml
blob: e8f260e1c5f3182fdb802751e4ba0eaf7d66c3af (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
	"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY % media-entities SYSTEM "./media-entities.xml"> %media-entities;
<!ENTITY media-indices SYSTEM "./media-indices.sgml">

<!ENTITY eg                     "e.&nbsp;g.">
<!ENTITY ie                     "i.&nbsp;e.">
<!ENTITY fd                     "File descriptor returned by <link linkend='func-open'><function>open()</function></link>.">
<!ENTITY i2c                    "I<superscript>2</superscript>C">
<!ENTITY return-value		"<title>Return Value</title><para>On success <returnvalue>0</returnvalue> is returned, on error <returnvalue>-1</returnvalue> and the <varname>errno</varname> variable is set appropriately:</para>">
<!ENTITY manvol                 "<manvolnum>2</manvolnum>">

<!-- Table templates: structs, structs w/union, defines. -->
<!ENTITY cs-str                 "<colspec colname='c1' colwidth='1*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='2*' /><spanspec spanname='hspan' namest='c1' nameend='c3' />">
<!ENTITY cs-ustr                "<colspec colname='c1' colwidth='1*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='1*' /><colspec colname='c4' colwidth='2*' /><spanspec spanname='hspan' namest='c1' nameend='c4' />">
<!ENTITY cs-def                 "<colspec colname='c1' colwidth='3*' /><colspec colname='c2' colwidth='1*' /><colspec colname='c3' colwidth='4*' /><spanspec spanname='hspan' namest='c1' nameend='c3' />">

<!-- Video for Linux mailing list address. -->
<!ENTITY v4l-ml                 "<ulink url='http://www.linuxtv.org/lists.php'>http://www.linuxtv.org/lists.php</ulink>">

<!-- LinuxTV v4l-dvb repository. -->
<!ENTITY v4l-dvb		"<ulink url='http://linuxtv.org/repo/'>http://linuxtv.org/repo/</ulink>">
]>

<book id="media_api">
<bookinfo>
<title>LINUX MEDIA INFRASTRUCTURE API</title>
<subtitle>Version 1.0</subtitle>

<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 and major parts of the sliced VBI
			     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@radix.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>mchehab@redhat.com</email>
				 </address>
			 </affiliation>
		 </author>
		 <author>
			 <!-- FIXME: Add the V4L authors -->
			 <firstname>Ralph</firstname>
			 <surname>Metzler</surname>
			 <othername role="mi">J. K.</othername>
			 <affiliation><address><email>rjkm@metzlerbros.de</email></address></affiliation>
		 </author>
		 <author>
			 <firstname>Marcus</firstname>
			 <surname>Metzler</surname>
			 <othername role="mi">O. C.</othername>
			 <affiliation><address><email>rjkm@metzlerbros.de</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>
		 <holder>Bill Dirks, Michael H. Schimek, Hans Verkuil, Martin
			 Rubli, Andy Walls, Mauro Carvalho Chehab, Ralph Metzler, Marcus Metzler</holder>
	 </copyright>

<legalnotice>

<para>Permission is granted to copy, distribute and/or modify
this document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation. A copy of the license is included in the chapter entitled
"GNU Free Documentation License"</para>
<para>Programming examples can be used and distributed without
	restrictions.</para>
</legalnotice>

</bookinfo>

<toc></toc> <!-- autogenerated -->
&sub-v4l2;
&sub-dvbapi;
</book>