source: multimedia/libdriv/gstreamer.xml@ 242345d

7.6-blfs 7.6-systemd kde5-14269 kde5-14686 systemd-13485
Last change on this file since 242345d was 242345d, checked in by Krejzi <krejzi@…>, 10 years ago

Remove some static libs.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@14084 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.4 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 &lfs76_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"/>
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 \
138 --with-package-name="GStreamer &gstreamer-version; BLFS" \
139 --with-package-origin="http://www.linuxfromscratch.org/blfs/view/&blfs-version;/" &amp;&amp;
140make</userinput></screen>
141
142 <para>
143 To test the results, issue: <command>make check</command>. There are
144 many other <filename>Makefile</filename> targets you can specify for
145 running the tests, issue <command>make -C tests/check help</command>
146 to see the complete list.
147 </para>
148
149 <para>
150 Now, as the <systemitem class="username">root</systemitem> user:
151 </para>
152
153<screen role="root"><userinput>make install &amp;&amp;
154install -v -m755 -d /usr/share/doc/gstreamer-0.10/design &amp;&amp;
155install -v -m644 docs/design/*.txt \
156 /usr/share/doc/gstreamer-0.10/design &amp;&amp;
157
158if [ -d /usr/share/doc/gstreamer-0.10/faq/html ]; then
159 chown -v -R root:root \
160 /usr/share/doc/gstreamer-0.10/*/html
161fi</userinput></screen>
162
163 <sect3>
164 <title>Testing the Installation</title>
165
166 <para>
167 To test the functionality of the
168 <application>GStreamer</application> installation, you can run a
169 simple test as an unprivileged user (you may have to run
170 <command>ldconfig</command> as the
171 <systemitem class="username">root</systemitem> user before
172 attempting the test).
173 </para>
174
175<screen><userinput>gst-launch -v fakesrc num_buffers=5 ! fakesink</userinput></screen>
176
177 <para>
178 If the command outputs a series of messages from fakesrc and
179 fakesink, everything is okay.
180 </para>
181
182 </sect3>
183
184 </sect2>
185
186 <sect2 role="commands">
187 <title>Command Explanations</title>
188
189 <para>
190 <command>sed ... gst/parse/grammar.y</command>: This command corrects
191 a problem caused by the most recent version of Bison.
192 </para>
193
194 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
195 href="../../xincludes/static-libraries.xml"/>
196
197 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
198 href="../../xincludes/gtk-doc-rebuild.xml"/>
199
200 <para>
201 <option>--enable-docbook</option>: This parameter is used to build
202 HTML, PDF and PostScript versions of the
203 <application>GStreamer</application> User's Manual, FAQ and Writer's
204 Guide. Note that you must have all the listed dependencies installed.
205 </para>
206
207 <para>
208 <command>chown -v -R root:root ...</command>: The documentation is
209 installed with the ownership of the user who untarred and built the
210 package. This command changes the ownership of the installed
211 documentation files to root:root, and is only executed if the
212 documentation files were built and installed.
213 </para>
214
215 <para><option>--libexecdir=/usr/lib</option>: This option puts the internal
216 support programs into <filename
217 class="directory">/usr/lib/gstreamer-0.10</filename> instead of
218 <filename class="directory">/usr/libexec/gstreamer-0.10.</filename> in
219 accordance with the old version of the FHS used before LFS-7.5.</para>
220
221 </sect2>
222
223 <sect2 role="content">
224 <title>Contents</title>
225
226 <segmentedlist>
227 <segtitle>Installed Programs</segtitle>
228 <segtitle>Installed Libraries</segtitle>
229 <segtitle>Installed Directories</segtitle>
230
231 <seglistitem>
232 <seg>
233 gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
234 gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10,
235 gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and
236 gst-xmllaunch-0.10
237 </seg>
238 <seg>
239 libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so,
240 libgstdataprotocol-0.10.so, libgstnet-0.10.so and
241 libgstreamer-0.10.so
242 </seg>
243 <seg>
244 /usr/include/gstreamer-0.10,
245 /usr/lib/gstreamer-0.10,
246 /usr/libexec/gstreamer-0.10,
247 /usr/share/gtk-doc/html/gstreamer-0.10,
248 /usr/share/gtk-doc/html/gstreamer-libs-0.10 and
249 /usr/share/gtk-doc/html/gstreamer-plugins-0.10
250 </seg>
251 </seglistitem>
252 </segmentedlist>
253
254 <variablelist>
255 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
256 <?dbfo list-presentation="list"?>
257 <?dbhtml list-presentation="table"?>
258
259 <varlistentry id="gst-feedback">
260 <term><command>gst-feedback-0.10</command></term>
261 <listitem>
262 <para>
263 generates debug info for <application>GStreamer</application>
264 bug reports.
265 </para>
266 <indexterm zone="gstreamer gst-feedback">
267 <primary sortas="b-gst-feedback">gst-feedback-0.10</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 <varlistentry id="gst-inspect">
273 <term><command>gst-inspect-0.10</command></term>
274 <listitem>
275 <para>
276 prints information about a
277 <application>GStreamer</application> plugin or element.
278 </para>
279 <indexterm zone="gstreamer gst-inspect">
280 <primary sortas="b-gst-inspect">gst-inspect-0.10</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="gst-launch">
286 <term><command>gst-launch-0.10</command></term>
287 <listitem>
288 <para>
289 is a tool that builds and runs basic
290 <application>GStreamer</application> pipelines.
291 </para>
292 <indexterm zone="gstreamer gst-launch">
293 <primary sortas="b-gst-launch">gst-launch-0.10</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="gst-typefind">
299 <term><command>gst-typefind-0.10</command></term>
300 <listitem>
301 <para>
302 uses the <application>GStreamer</application> type finding system
303 to determine the relevant <application>GStreamer</application>
304 plugin to parse or decode a file, and determine the corresponding
305 MIME type.
306 </para>
307 <indexterm zone="gstreamer gst-typefind">
308 <primary sortas="b-gst-typefind">gst-typefind-0.10</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="gst-xmlinspect">
314 <term><command>gst-xmlinspect-0.10</command></term>
315 <listitem>
316 <para>
317 prints information about a <application>GStreamer</application>
318 plugin or element in XML document format.
319 </para>
320 <indexterm zone="gstreamer gst-xmlinspect">
321 <primary sortas="b-gst-xmlinspect">gst-xmlinspect-0.10</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="gst-xmllaunch">
327 <term><command>gst-xmllaunch-0.10</command></term>
328 <listitem>
329 <para>
330 is used to build and run a basic <application>GStreamer</application>
331 pipeline, loading it from an XML description.
332 </para>
333 <indexterm zone="gstreamer gst-xmllaunch">
334 <primary sortas="b-gst-xmllaunch">gst-xmllaunch-0.10</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 </variablelist>
340
341 </sect2>
342
343</sect1>
Note: See TracBrowser for help on using the repository browser.