source: multimedia/libdriv/gstreamer.xml@ 5c22cb01

systemd-13485
Last change on this file since 5c22cb01 was ac38e9dc, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Import back into SVN from Github

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

  • Property mode set to 100644
File size: 11.1 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 \
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 -dm755 /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 -Rv 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 </sect2>
216
217 <sect2 role="content">
218 <title>Contents</title>
219
220 <segmentedlist>
221 <segtitle>Installed Programs</segtitle>
222 <segtitle>Installed Libraries</segtitle>
223 <segtitle>Installed Directories</segtitle>
224
225 <seglistitem>
226 <seg>
227 gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
228 gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10,
229 gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and
230 gst-xmllaunch-0.10
231 </seg>
232 <seg>
233 libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so,
234 libgstdataprotocol-0.10.so, libgstnet-0.10.so and
235 libgstreamer-0.10.so
236 </seg>
237 <seg>
238 /usr/include/gstreamer-0.10,
239 /usr/lib/gstreamer-0.10,
240 /usr/libexec/gstreamer-0.10,
241 /usr/share/gtk-doc/html/gstreamer-0.10,
242 /usr/share/gtk-doc/html/gstreamer-libs-0.10 and
243 /usr/share/gtk-doc/html/gstreamer-plugins-0.10
244 </seg>
245 </seglistitem>
246 </segmentedlist>
247
248 <variablelist>
249 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
250 <?dbfo list-presentation="list"?>
251 <?dbhtml list-presentation="table"?>
252
253 <varlistentry id="gst-feedback">
254 <term><command>gst-feedback-0.10</command></term>
255 <listitem>
256 <para>
257 generates debug info for <application>GStreamer</application>
258 bug reports.
259 </para>
260 <indexterm zone="gstreamer gst-feedback">
261 <primary sortas="b-gst-feedback">gst-feedback-0.10</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="gst-inspect">
267 <term><command>gst-inspect-0.10</command></term>
268 <listitem>
269 <para>
270 prints information about a
271 <application>GStreamer</application> plugin or element.
272 </para>
273 <indexterm zone="gstreamer gst-inspect">
274 <primary sortas="b-gst-inspect">gst-inspect-0.10</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="gst-launch">
280 <term><command>gst-launch-0.10</command></term>
281 <listitem>
282 <para>
283 is a tool that builds and runs basic
284 <application>GStreamer</application> pipelines.
285 </para>
286 <indexterm zone="gstreamer gst-launch">
287 <primary sortas="b-gst-launch">gst-launch-0.10</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="gst-typefind">
293 <term><command>gst-typefind-0.10</command></term>
294 <listitem>
295 <para>
296 uses the <application>GStreamer</application> type finding system
297 to determine the relevant <application>GStreamer</application>
298 plugin to parse or decode a file, and determine the corresponding
299 MIME type.
300 </para>
301 <indexterm zone="gstreamer gst-typefind">
302 <primary sortas="b-gst-typefind">gst-typefind-0.10</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 <varlistentry id="gst-xmlinspect">
308 <term><command>gst-xmlinspect-0.10</command></term>
309 <listitem>
310 <para>
311 prints information about a <application>GStreamer</application>
312 plugin or element in XML document format.
313 </para>
314 <indexterm zone="gstreamer gst-xmlinspect">
315 <primary sortas="b-gst-xmlinspect">gst-xmlinspect-0.10</primary>
316 </indexterm>
317 </listitem>
318 </varlistentry>
319
320 <varlistentry id="gst-xmllaunch">
321 <term><command>gst-xmllaunch-0.10</command></term>
322 <listitem>
323 <para>
324 is used to build and run a basic <application>GStreamer</application>
325 pipeline, loading it from an XML description.
326 </para>
327 <indexterm zone="gstreamer gst-xmllaunch">
328 <primary sortas="b-gst-xmllaunch">gst-xmllaunch-0.10</primary>
329 </indexterm>
330 </listitem>
331 </varlistentry>
332
333 </variablelist>
334
335 </sect2>
336
337</sect1>
Note: See TracBrowser for help on using the repository browser.