source: multimedia/libdriv/gst-plugins.xml@ 6b40aa9

10.0 10.1 11.0 11.1 11.2 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 6b40aa9 was 6b40aa9, checked in by Randy McMurchy <randy@…>, 16 years ago

Renamed some indexing ids in the obsolete GStreamer Plug-ins instructions to accomodate the new GStreamer Base Plug-ins instructions

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

  • Property mode set to 100644
File size: 15.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!ENTITY gst-plugins-download-http "http://gstreamer.freedesktop.org/src/gst-plugins/gst-plugins-&gst-plugins-version;.tar.bz2">
8<!ENTITY gst-plugins-download-ftp "&gnome-download-ftp;/gst-plugins/0.8/gst-plugins-&gst-plugins-version;.tar.bz2">
9<!ENTITY gst-plugins-md5sum "ea787eeed3761ff03cb60ecebebe1c30">
10<!ENTITY gst-plugins-size "2.4 MB">
11<!ENTITY gst-plugins-buildsize "up to 109 MB (depends on what dependencies are installed)">
12<!ENTITY gst-plugins-time "up to 3.6 SBU">
13]>
14
15<sect1 id="gst-plugins" xreflabel="GStreamer Plug-ins-&gst-plugins-version;">
16 <?dbhtml filename="gst-plugins.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 <keywordset>
22 <keyword role="package">gst-plugins-&gst-plugins-version;.tar</keyword>
23 <keyword role="ftpdir">gst-plugins</keyword>
24 </keywordset>
25 </sect1info>
26
27 <title>GStreamer Plug-ins-&gst-plugins-version;</title>
28
29 <indexterm zone="gst-plugins">
30 <primary sortas="a-GStreamer-Plug-ins">GStreamer Plug-ins</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to GStreamer Plug-ins</title>
35
36 <para>The <application>GStreamer Plug-ins</application> package builds
37 graphics and multimedia CODEC interface modules for the
38 <application>GStreamer</application> package. There are over 170 different
39 modules that can be built, providing <application>GStreamer</application>
40 the capability to create a pipeline for almost every known media
41 stream. In recent versions of <application>GStreamer Plug-ins</application>,
42 the <application>FFmpeg</application> plugin has been removed and is now
43 released in a separate module. You can find out information about this
44 module and how to download it from <ulink
45 url="http://gstreamer.freedesktop.org/modules/gst-ffmpeg.html"/>.</para>
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>Download (HTTP): <ulink url="&gst-plugins-download-http;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download (FTP): <ulink url="&gst-plugins-download-ftp;"/></para>
54 </listitem>
55 <listitem>
56 <para>Download MD5 sum: &gst-plugins-md5sum;</para>
57 </listitem>
58 <listitem>
59 <para>Download size: &gst-plugins-size;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated disk space required: &gst-plugins-buildsize;</para>
63 </listitem>
64 <listitem>
65 <para>Estimated build time: &gst-plugins-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">GStreamer Plug-ins Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required"><xref linkend="gstreamer"/></para>
73
74 <bridgehead renderas="sect4">Optional Utilities (Graphics, Compression, Misc.)</bridgehead>
75 <para role="optional"><xref linkend="aalib"/>,
76 <xref linkend="cairo"/>,
77 <xref linkend="cdparanoia"/>,
78 <xref linkend="freetype2"/>,
79 <xref linkend="GConf"/>,
80 <xref linkend="gtk2"/>,
81 <xref linkend="gnome-vfs"/>,
82 <ulink url="http://talinux.fi.tal.org/pub/talinux/sources/Hermes-1.3.3.tar.gz">Hermes</ulink>,
83 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
84 <ulink url="http://www.gnu.org/software/libcdio/">libcdio</ulink>,
85 <ulink url="http://cvs.sourceforge.net/viewcvs.py/codecs/libcolorspace-pre/">libcolorspace</ulink>,
86 <xref linkend="libjpeg"/> or
87 <ulink url="http://sourceforge.net/projects/mjpeg/">MMX Jpeg</ulink>,
88 <ulink url="http://eetpc20.bd.psu.edu/~rfisher/Research/Libmmx/libmmx.html">libmmx</ulink>,
89 <xref linkend="libmng"/>,
90 <ulink url="http://www.schleef.org/liboil/">liboil</ulink>,
91 <xref linkend="libpng"/>,
92 <xref linkend="NASM"/>,
93 <xref linkend="pango"/>, and
94 <xref linkend="x-window-system"/></para>
95
96 <bridgehead renderas="sect4">Optional Audio Libraries/Drivers/CODECs</bridgehead>
97 <para role="optional"><xref linkend="alsa"/>,
98 <xref linkend="arts"/>,
99 <xref linkend="audiofile"/>,
100 <ulink url="http://www.comedi.org/cgi-bin/viewcvs.cgi/audioresample/">audioresample</ulink>,
101 <xref linkend="esound"/>,
102 <ulink url="http://sourceforge.net/projects/faac">FAAC</ulink>,
103 <ulink url="http://sourceforge.net/projects/faac">FAAD2</ulink>,
104 <xref linkend="flac"/>,
105 <ulink url="http://kbs.cs.tu-berlin.de/~jutta/toast.html">GSM</ulink>,
106 <ulink url="http://jackit.sourceforge.net/">JACK</ulink>,
107 <xref linkend="lame"/>,
108 <xref linkend="liba52"/>,
109 <ulink url="http://ronald.bitfreak.net/priv/">libamrnb</ulink>,
110 <ulink url="http://libcdaudio.sourceforge.net/">libcdaudio</ulink>,
111 <ulink url="http://www.videolan.org/libdca.html">libdts</ulink>,
112 <xref linkend="libmad"/> (and
113 <ulink url="http://sourceforge.net/projects/mad/">libid3tag</ulink>),
114 <xref linkend="libmikmod"/>,
115 <ulink url="http://www.musepack.net/">libmpcdec</ulink>,
116 <xref linkend="libmusicbrainz"/>,
117 <xref linkend="libogg"/>,
118 <ulink url="http://www.linux1394.org/">libraw1394</ulink> (and
119 <ulink url="http://sourceforge.net/projects/libavc1394/">libavc1394</ulink>),
120 <ulink url="http://www.icecast.org/">libshout</ulink>,
121 <ulink url="http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/">libsidplay</ulink>,
122 <ulink url="http://www.mega-nerd.com/libsndfile/">libsndfile</ulink>,
123 <xref linkend="libvorbis"/>,
124 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
125 <xref linkend="nas"/>,
126 <ulink url="http://0pointer.de/lennart/projects/polypaudio/">polypaudio</ulink>,
127 <xref linkend="speex"/>,
128 <ulink url="http://www.theora.org/">Theora</ulink>,
129 <ulink url="http://www.xiph.org/vorbis/">Tremor</ulink>,
130 <ulink url="http://www.wavpack.com/">WavPack</ulink>, and
131 <ulink url="http://developers.videolan.org/x264.html">x264</ulink></para>
132
133 <bridgehead renderas="sect4">Optional Video Libraries/Drivers/CODECs</bridgehead>
134 <para role="optional"><ulink url="http://sourceforge.net/projects/dirac/">Dirac</ulink>,
135 <ulink url="http://directfb.org/">DirectFB</ulink>,
136<!-- Dead link
137 <ulink url="http://www.divx.com/divx/linux/">DivX4Linux</ulink>,
138-->
139 <ulink url="http://dxr3.sourceforge.net/">DXR3</ulink>,
140 <xref linkend="libdv"/>,
141 <ulink url="http://sourceforge.net/projects/dvd/">libdvdnav</ulink>,
142 <xref linkend="libdvdread"/>,
143 <xref linkend="libfame"/>,
144 <xref linkend="libmpeg2"/>,
145 <!-- <ulink url="https://cvs.comedi.org/cgi-bin/viewcvs.cgi/librfb/">librfb</ulink>, -->
146 <ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
147 <ulink url="http://www.thedirks.org/v4l2/">V4L2</ulink>, and
148 <xref linkend="xvid"/></para>
149
150 <bridgehead renderas="sect4">Optional Multimedia Utilities</bridgehead>
151 <para role="optional"><ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
152 <ulink url="http://sourceforge.net/projects/libvisual/">libvisual</ulink>,
153 <xref linkend="sdl"/>,
154 <ulink url="http://swfdec.sourceforge.net/">swfdec</ulink>, and
155 <xref linkend="xine-lib"/></para>
156
157 <para condition="html" role="usernotes">User Notes:
158 <ulink url="&blfs-wiki;/gst-plugins"/></para>
159
160 </sect2>
161
162 <sect2 role="installation">
163 <title>Installation of GStreamer Plug-ins</title>
164
165 <para>Install <application>GStreamer Plug-ins</application> by running the
166 following commands:</para>
167
168<screen><userinput>sed -i -e 's|LIBS="-lGLU|LIBS="-L/usr/X11R6/lib -lGLU|' \
169 -e '/GST_DOC/d' \
170 -e 's/lx264 -lm/&amp; -lpthread/' \
171 configure &amp;&amp;
172sed -i 's/X264_LIBS@/&amp; -lpthread/' ext{,/x264}/Makefile.in &amp;&amp;
173
174./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
175make</userinput></screen>
176
177 <para>To check the results, issue:</para>
178
179<screen><userinput>sed -i 's|:\$(GST_LIB_DIR)/..||' gst/audioconvert/Makefile &amp;&amp;
180make -C gst/audioconvert check</userinput></screen>
181
182 <para> On some platforms in certain situations the tests may fail because
183 one or more of the plugins will fail to register. This will be displayed in
184 the output from the command. If this happens, you are urged to rename the
185 offending plugin and repeat the
186 <command>make -C gst/audioconvert check</command> command. Both tests
187 should pass before you continue. Simply renaming the offending plugin by
188 adding <filename class='extension'>.BAD</filename> to the end of the
189 filename is sufficient. Here is an example:</para>
190
191<screen><userinput>mv gst/audioconvert/../../ext/xine/.libs/libgstxine.so{,.BAD}</userinput></screen>
192
193 <para>After the tests have completed successfully, if you had to rename any
194 of the plugins, ensure you rename it back to the original, or the
195 installation step will fail.</para>
196
197 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
198
199<screen role="root"><userinput>make install &amp;&amp;
200ldconfig</userinput></screen>
201
202 <para>If you had to rename any of the plugins for the tests to complete
203 successfully, you will have to also rename (or remove) them so that the
204 <command>gst-register</command> command will complete successfully. The
205 plugins were installed into the
206 <filename class='directory'>/usr/lib/gstreamer-0.8</filename>
207 directory. Finish the installation by running the following command as the
208 <systemitem class="username">root</systemitem> user:</para>
209
210<screen role="root"><userinput>gst-register</userinput></screen>
211
212 <caution>
213 <para>If you <command>touch</command>, <command>strip</command> or do
214 anything else that can update the time stamp (modification time) of the
215 plugin files, ensure you rerun the <command>gst-register</command>
216 command as the <systemitem class="username">root</systemitem> user again
217 so that the time stamp of the global registry file
218 (<filename>/var/cache/gstreamer-0.8/registry.xml</filename>) is dated
219 later than the time stamp of any of the plugin files.</para>
220 </caution>
221
222 <sect3>
223 <title>Testing the Installation</title>
224
225 <para>To test the functionality of the completed
226 <application>GStreamer</application> installation, you can run a couple
227 of tests. Perform the tests as an unprivileged user.</para>
228
229 <para>The first test should complete without any errors displayed to
230 the screen:</para>
231
232<screen><userinput>gst-launch --iterations=10000 sinesrc ! fakesink</userinput></screen>
233
234 <para>For the next test you'll need to choose an output method valid for
235 your system such as osssink/esdsink/artsdsink/alsasink/jacksink. Replace
236 the <replaceable>&lt;output_sink&gt;</replaceable> in the command below with
237 a valid output method. Running the command should produce a C tone for a
238 short duration.</para>
239
240<screen><userinput>gst-launch --iterations=50 sinesrc ! <replaceable>&lt;output_sink&gt;</replaceable></userinput></screen>
241
242 </sect3>
243
244 </sect2>
245
246 <sect2 role="commands">
247 <title>Command Explanations</title>
248
249 <para><command>sed -i ... configure</command>: The check for the OpenGL
250 (Mesa) libraries will fail if <application>X</application> is installed in
251 any directory other than <filename class='directory'>/usr</filename>. This
252 commands adds an additional search path. Additionally, the command removes
253 a misplaced line and fixes the checks for the
254 <application>x264</application> library.</para>
255
256 <para><command>sed -i ... ext{,/x264}/Makefile.in</command>: This command
257 adds the <filename class='libraryfile'>libpthread.so</filename> library to
258 the list of libraries required to properly compile the
259 <application>x264</application> library.</para>
260
261 <para><option>--with-gconf-schema-file-dir=&gnome-etc-dir;/gconf/schemas</option>:
262 Use this option if you have the <application>GNOME-2</application>
263 <application>GConf</application> package installed.</para>
264
265 <para><option>--enable-gdk-pixbuf-loader</option>: Use this option to build
266 the GDK pixbuf loader module if you have <application>GTK+-2</application>
267 installed.</para>
268
269 <para><option>--enable-xine</option>: Use this option to build the
270 <application>Xine</application> wrapper module if you have the
271 <application>Xine Libraries</application> package installed. On some
272 platforms, the module will have some corruption and cause the test suite
273 and <command>gst-register</command> command to fail.</para>
274
275 <!--
276 <para><option>-enable-xine</option>: Using this option to build the
277 <application>Xine</application> wrapper module will break the build if you
278 have <application>xine-libs</application>-&xine-lib-version;
279 installed.</para>
280 -->
281
282 <para>Note: all other modules are built if the <command>configure</command>
283 script discovers the required dependency package. To prevent a module from
284 being built, pass
285 <option>--disable-<replaceable>&lt;module&gt;</replaceable></option> to
286 <command>configure</command>. Run <command>configure --help</command>
287 for all the available module names.</para>
288
289 </sect2>
290
291 <sect2 role="content">
292 <title>Contents</title>
293
294 <segmentedlist>
295 <segtitle>Installed Programs</segtitle>
296 <segtitle>Installed Libraries</segtitle>
297 <segtitle>Installed Directories</segtitle>
298
299 <seglistitem>
300 <seg>gst-launch-ext-0.8 and gst-visualise-0.8</seg>
301 <seg>libgst*.{so,a}, numerous <application>GStreamer</application> plugins,
302 and a <application>Gstreamer</application> GDK pixbuf loader module</seg>
303 <seg>&gnome-etc-dir;/gconf/gconf.xml.defaults/schemas/system/gstreamer,
304 &gnome-etc-dir;/gconf/gconf.xml.defaults/system/gstreamer,
305 and many subdirs of /usr/include/gstreamer-0.8/gst</seg>
306 </seglistitem>
307 </segmentedlist>
308
309 <variablelist>
310 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
311 <?dbfo list-presentation="list"?>
312 <?dbhtml list-presentation="table"?>
313
314 <varlistentry id="gst-launch-ext">
315 <term><command>gst-launch-ext-0.8</command></term>
316 <listitem>
317 <para>is used to run a basic predefined
318 <application>GStreamer</application> pipeline as a quick test to ensure
319 proper working of codecs and <application>GStreamer</application>.</para>
320 <indexterm zone="gst-plugins gst-launch-ext">
321 <primary sortas="b-gst-launch-ext">gst-launch-ext-0.8</primary>
322 </indexterm>
323 </listitem>
324 </varlistentry>
325
326 <varlistentry id="xxgst-visualise">
327 <term><command>gst-visualise-0.8</command></term>
328 <listitem>
329 <para>is used to run a basic <application>GStreamer</application>
330 pipeline to display a graphical visualisation of an audio stream.</para>
331 <indexterm zone="gst-plugins xxgst-visualise">
332 <primary sortas="b-gst-visualise">gst-visualise-0.8</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.