source: multimedia/libdriv/gstreamer.xml@ dd34be2c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since dd34be2c was 4116c85, checked in by Ken Moffat <ken@…>, 10 years ago

tags

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

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