source: archive/gstreamer.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 10.9 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gstreamer-download-http "&gnome-download-http;/gstreamer/0.10/gstreamer-&gstreamer-version;.tar.xz">
8 <!ENTITY gstreamer-download-ftp "&gnome-download-ftp;/gstreamer/0.10/gstreamer-&gstreamer-version;.tar.xz">
9 <!ENTITY gstreamer-md5sum "15389c73e091b1dda915279c388b9cb2">
10 <!ENTITY gstreamer-size "2.9 MB">
11 <!ENTITY gstreamer-buildsize "90 MB">
12 <!ENTITY gstreamer-time "1.2 SBU">
13]>
14
15<sect1 id="gstreamer" xreflabel="GStreamer-&gstreamer-version;">
16 <?dbhtml filename="gstreamer.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>GStreamer-&gstreamer-version;</title>
23
24 <indexterm zone="gstreamer">
25 <primary sortas="a-GStreamer">GStreamer</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to GStreamer</title>
30<!--
31 <para>
32 <application>GStreamer</application> is a streaming media framework that
33 enables applications to share a common set of plugins for things like
34 video decoding and encoding, audio encoding and decoding, audio and video
35 filters, audio visualisation, Web streaming and anything else that streams
36 in real-time or otherwise. It is modelled after research software worked
37 on at the Oregon Graduate Institute. After installing
38 <application>GStreamer</application>, you'll likely need to install one or
39 more of the <xref linkend="gst-plugins-bad"/>,
40 <xref linkend="gst-plugins-good"/>, <xref linkend="gst-plugins-ugly"/> and
41 <xref linkend="gst-ffmpeg"/> packages.
42 </para>
43-->
44 &lfs77_checked;
45
46 &gst-compat;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&gstreamer-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&gstreamer-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &gstreamer-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &gstreamer-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &gstreamer-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &gstreamer-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">GStreamer Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="glib2"/> and
87 <xref linkend="libxml2"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional (Required if building GNOME)</bridgehead>
91 <para role="optional">
92 <xref linkend="gobject-introspection"/>
93 </para>
94
95 <bridgehead renderas="sect4">Optional</bridgehead>
96 <para role="optional">
97 <xref linkend="gsl"/>,
98 <xref linkend="valgrind"/>
99 (optionally used during the unit regression tests)
100 </para>
101
102 <bridgehead renderas="sect4">
103 Optional (Required to rebuild the API Documentation)
104 </bridgehead>
105 <para role="optional">
106 <xref linkend="gtk-doc"/> and
107 <xref linkend="python2"/>
108 </para>
109
110 <bridgehead renderas="sect4">Optional (Required to Build Manuals)</bridgehead>
111 <para role="optional">
112 <xref linkend="docbook-utils"/>,
113 <xref linkend="gs"/>
114 <xref linkend="libxslt"/> and
115 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
116 </para>
117
118 <para condition="html" role="usernotes">User Notes:
119 <ulink url="&blfs-wiki;/gstreamer"/>
120 </para>
121 </sect2>
122
123 <sect2 role="installation">
124 <title>Installation of GStreamer</title>
125
126 <para>
127 Install <application>GStreamer</application> by running the following
128 commands:
129 </para>
130
131<screen><userinput>sed -i -e '/YYLEX_PARAM/d' \
132 -e '/parse-param.*scanner/i %lex-param { void *scanner }' \
133 gst/parse/grammar.y &amp;&amp;
134
135./configure --prefix=/usr \
136 --disable-static &amp;&amp;
137make</userinput></screen>
138
139 <para>
140 To test the results, issue: <command>make check</command>. There are
141 many other <filename>Makefile</filename> targets you can specify for
142 running the tests, issue <command>make -C tests/check help</command>
143 to see the complete list.
144 </para>
145
146 <para>
147 Now, as the <systemitem class="username">root</systemitem> user:
148 </para>
149
150<screen role="root"><userinput>make install &amp;&amp;
151install -v -m755 -d /usr/share/doc/gstreamer-0.10/design &amp;&amp;
152install -v -m644 docs/design/*.txt \
153 /usr/share/doc/gstreamer-0.10/design &amp;&amp;
154
155if [ -d /usr/share/doc/gstreamer-0.10/faq/html ]; then
156 chown -v -R root:root \
157 /usr/share/doc/gstreamer-0.10/*/html
158fi</userinput></screen>
159
160 <sect3>
161 <title>Testing the Installation</title>
162
163 <para>
164 To test the functionality of the
165 <application>GStreamer</application> installation, you can run a
166 simple test as an unprivileged user (you may have to run
167 <command>ldconfig</command> as the
168 <systemitem class="username">root</systemitem> user before
169 attempting the test).
170 </para>
171
172<screen><userinput>gst-launch -v fakesrc num_buffers=5 ! fakesink</userinput></screen>
173
174 <para>
175 If the command outputs a series of messages from fakesrc and
176 fakesink, everything is okay.
177 </para>
178
179 </sect3>
180
181 </sect2>
182
183 <sect2 role="commands">
184 <title>Command Explanations</title>
185
186 <para>
187 <command>sed ... gst/parse/grammar.y</command>: This command corrects
188 a problem caused by the most recent version of Bison.
189 </para>
190
191 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
192 href="../../xincludes/static-libraries.xml"/>
193
194 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
195 href="../../xincludes/gtk-doc-rebuild.xml"/>
196
197 <para>
198 <option>--enable-docbook</option>: This parameter is used to build
199 HTML, PDF and PostScript versions of the
200 <application>GStreamer</application> User's Manual, FAQ and Writer's
201 Guide. Note that you must have all the listed dependencies installed.
202 </para>
203
204 <para>
205 <command>chown -v -R root:root ...</command>: The documentation is
206 installed with the ownership of the user who untarred and built the
207 package. This command changes the ownership of the installed
208 documentation files to root:root, and is only executed if the
209 documentation files were built and installed.
210 </para>
211
212 </sect2>
213
214 <sect2 role="content">
215 <title>Contents</title>
216
217 <segmentedlist>
218 <segtitle>Installed Programs</segtitle>
219 <segtitle>Installed Libraries</segtitle>
220 <segtitle>Installed Directories</segtitle>
221
222 <seglistitem>
223 <seg>
224 gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
225 gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10,
226 gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and
227 gst-xmllaunch-0.10
228 </seg>
229 <seg>
230 libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so,
231 libgstdataprotocol-0.10.so, libgstnet-0.10.so and
232 libgstreamer-0.10.so
233 </seg>
234 <seg>
235 /usr/include/gstreamer-0.10,
236 /usr/lib/gstreamer-0.10,
237 /usr/libexec/gstreamer-0.10,
238 /usr/share/gtk-doc/html/gstreamer-0.10,
239 /usr/share/gtk-doc/html/gstreamer-libs-0.10 and
240 /usr/share/gtk-doc/html/gstreamer-plugins-0.10
241 </seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="gst-feedback">
251 <term><command>gst-feedback-0.10</command></term>
252 <listitem>
253 <para>
254 generates debug info for <application>GStreamer</application>
255 bug reports.
256 </para>
257 <indexterm zone="gstreamer gst-feedback">
258 <primary sortas="b-gst-feedback">gst-feedback-0.10</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="gst-inspect">
264 <term><command>gst-inspect-0.10</command></term>
265 <listitem>
266 <para>
267 prints information about a
268 <application>GStreamer</application> plugin or element.
269 </para>
270 <indexterm zone="gstreamer gst-inspect">
271 <primary sortas="b-gst-inspect">gst-inspect-0.10</primary>
272 </indexterm>
273 </listitem>
274 </varlistentry>
275
276 <varlistentry id="gst-launch">
277 <term><command>gst-launch-0.10</command></term>
278 <listitem>
279 <para>
280 is a tool that builds and runs basic
281 <application>GStreamer</application> pipelines.
282 </para>
283 <indexterm zone="gstreamer gst-launch">
284 <primary sortas="b-gst-launch">gst-launch-0.10</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="gst-typefind">
290 <term><command>gst-typefind-0.10</command></term>
291 <listitem>
292 <para>
293 uses the <application>GStreamer</application> type finding system
294 to determine the relevant <application>GStreamer</application>
295 plugin to parse or decode a file, and determine the corresponding
296 MIME type.
297 </para>
298 <indexterm zone="gstreamer gst-typefind">
299 <primary sortas="b-gst-typefind">gst-typefind-0.10</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="gst-xmlinspect">
305 <term><command>gst-xmlinspect-0.10</command></term>
306 <listitem>
307 <para>
308 prints information about a <application>GStreamer</application>
309 plugin or element in XML document format.
310 </para>
311 <indexterm zone="gstreamer gst-xmlinspect">
312 <primary sortas="b-gst-xmlinspect">gst-xmlinspect-0.10</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316
317 <varlistentry id="gst-xmllaunch">
318 <term><command>gst-xmllaunch-0.10</command></term>
319 <listitem>
320 <para>
321 is used to build and run a basic <application>GStreamer</application>
322 pipeline, loading it from an XML description.
323 </para>
324 <indexterm zone="gstreamer gst-xmllaunch">
325 <primary sortas="b-gst-xmllaunch">gst-xmllaunch-0.10</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329
330 </variablelist>
331
332 </sect2>
333
334</sect1>
Note: See TracBrowser for help on using the repository browser.