source: archive/gstreamer.xml@ f3429309

10.0 10.1 11.0 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f3429309 was f3429309, checked in by Fernando de Oliveira <fernando@…>, 6 years ago
  • mupdf-1.8: minor reformat.
  • removing spaces from EOL, from Denis Mugnier.
  • BLFS/trunk/BOOK/kde/add/kdepim-runtime.xml: needed to fix to validate the book. One chunck had been removed. Bruce, please check if it is OK, now.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16645 af4574ff-66df-0310-9fd7-8a98e5e911e0

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