source: multimedia/libdriv/gst-plugins.xml@ a16e2c0c

10.0 10.1 11.0 11.1 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 qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a16e2c0c was a16e2c0c, checked in by Randy McMurchy <randy@…>, 16 years ago

Updated numerous items in the GStreamer Plug-ins instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5610 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 "ftp://ftp.gnome.org/pub/GNOME/sources/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 X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</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 <ulink url="http://www.divx.com/divx/linux/">DivX4Linux</ulink>,
137 <ulink url="http://dxr3.sourceforge.net/">DXR3</ulink>,
138 <xref linkend="libdv"/>,
139 <ulink url="http://sourceforge.net/projects/dvd/">libdvdnav</ulink>,
140 <xref linkend="libdvdread"/>,
141 <xref linkend="libfame"/>,
142 <xref linkend="libmpeg2"/>,
143 <!-- <ulink url="https://cvs.comedi.org/cgi-bin/viewcvs.cgi/librfb/">librfb</ulink>, -->
144 <ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
145 <ulink url="http://www.thedirks.org/v4l2/">V4L2</ulink>, and
146 <xref linkend="xvid"/></para>
147
148 <bridgehead renderas="sect4">Optional Multimedia Utilities</bridgehead>
149 <para role="optional"><ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
150 <ulink url="http://sourceforge.net/projects/libvisual/">libvisual</ulink>,
151 <xref linkend="sdl"/>,
152 <ulink url="http://swfdec.sourceforge.net/">swfdec</ulink>, and
153 <xref linkend="xine-lib"/></para>
154
155 </sect2>
156
157 <sect2 role="installation">
158 <title>Installation of GStreamer Plug-ins</title>
159
160 <para>Install <application>GStreamer Plug-ins</application> by running the
161 following commands:</para>
162
163<screen><userinput>sed -i -e 's|LIBS="-lGLU|LIBS="-L/usr/X11R6/lib -lGLU|' \
164 -e '/GST_DOC/d' \
165 -e 's/lx264 -lm/&amp; -lpthread/' \
166 configure &amp;&amp;
167sed -i 's/X264_LIBS@/&amp; -lpthread/' ext{,/x264}/Makefile.in &amp;&amp;
168
169./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
170make</userinput></screen>
171
172 <para>To check the results, issue:</para>
173
174<screen><userinput>sed -i 's|:\$(GST_LIB_DIR)/..||' gst/audioconvert/Makefile &amp;&amp;
175make -C gst/audioconvert check</userinput></screen>
176
177 <para> On some platforms in certain situations the tests may fail because
178 one or more of the plugins will fail to register. This will be displayed in
179 the output from the command. If this happens, you are urged to rename the
180 offending plugin and repeat the
181 <command>make -C gst/audioconvert check</command> command. Both tests
182 should pass before you continue. Simply renaming the offending plugin by
183 adding <filename class='extension'>.BAD</filename> to the end of the
184 filename is sufficient. Here is an example:</para>
185
186<screen><userinput>mv gst/audioconvert/../../ext/xine/.libs/libgstxine.so \
187 gst/audioconvert/../../ext/xine/.libs/libgstxine.so.BAD</userinput></screen>
188
189 <para>After the tests have completed successfully, if you had to rename any
190 of the plugins, ensure you rename it back to the original, or the
191 installation step will fail.</para>
192
193 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
194
195<screen role="root"><userinput>make install &amp;&amp;
196ldconfig</userinput></screen>
197
198 <para>If you had to rename any of the plugins for the tests to complete
199 successfully, you will have to also rename (or remove) them so that the
200 <command>gst-register</command> command will complete successfully. The
201 plugins were installed into the
202 <filename class='directory'>/usr/lib/gstreamer-0.8</filename>
203 directory. Finish the installation by running the following command as the
204 <systemitem class="username">root</systemitem> user:</para>
205
206<screen role="root"><userinput>gst-register</userinput></screen>
207
208 <caution>
209 <para>If you <command>touch</command>, <command>strip</command> or do
210 anything else that can update the time stamp (modification time) of the
211 plugin files, ensure you rerun the <command>gst-register</command>
212 command as the <systemitem class="username">root</systemitem> user again
213 so that the time stamp of the global registry file
214 (<filename>/var/cache/gstreamer-0.8/registry.xml</filename>) is dated
215 later than the time stamp of any of the plugin files.</para>
216 </caution>
217
218 <sect3>
219 <title>Testing the Installation</title>
220
221 <para>To test the functionality of the completed
222 <application>GStreamer</application> installation, you can run a couple
223 of tests. Perform the tests as an unprivileged user.</para>
224
225 <para>The first test should complete without any errors displayed to
226 the screen:</para>
227
228<screen><userinput>gst-launch --iterations=10000 sinesrc ! fakesink</userinput></screen>
229
230 <para>For the next test you'll need to choose an output method valid for
231 your system such as osssink/esdsink/artsdsink/alsasink/jacksink. Replace
232 the <replaceable>[output_sink]</replaceable> in the command below with
233 a valid output method. Running the command should produce a C tone for a
234 short duration.</para>
235
236<screen><userinput>gst-launch --iterations=50 sinesrc ! <replaceable>[output_sink]</replaceable></userinput></screen>
237
238 </sect3>
239
240 </sect2>
241
242 <sect2 role="commands">
243 <title>Command Explanations</title>
244
245 <para><command>sed -i ... configure</command>: The check for the OpenGL
246 (Mesa) libraries will fail if <application>X</application> is installed in
247 any directory other than <filename class='directory'>/usr</filename>. This
248 commands adds an additional search path. Additionally, the command removes
249 a misplaced line and fixes the checks for the
250 <application>x264</application> library.</para>
251
252 <para><command>sed -i ... ext{,/x264}/Makefile.in</command>: This command
253 adds the <filename class='libraryfile'>libpthread.so</filename> library to
254 the list of libraries required to properly compile the
255 <application>x264</application> library.</para>
256
257 <para><option>--with-gconf-schema-file-dir=/etc/gnome/gconf/schemas</option>:
258 Use this option if you have the <application>GNOME-2</application>
259 <application>GConf</application> package installed.</para>
260
261 <para><option>--enable-gdk-pixbuf-loader</option>: Use this option to build
262 the GDK pixbuf loader module if you have <application>GTK+-2</application>
263 installed.</para>
264
265 <para><option>-enable-xine</option>: Use this option to build the
266 <application>Xine</application> wrapper module if you have the
267 <application>Xine Libraries</application> package installed. On some
268 platforms, the module will have some corruption and cause the test suite
269 and <command>gst-register</command> command to fail.</para>
270
271 <!--
272 <para><option>-enable-xine</option>: Using this option to build the
273 <application>Xine</application> wrapper module will break the build if you
274 have <application>xine-libs</application>-&xine-lib-version;
275 installed.</para>
276 -->
277
278 <para>Note: all other modules are built if the <command>configure</command>
279 script discovers the required dependency package. To prevent a module from
280 being built, pass
281 <option>--disable-<replaceable>[module]</replaceable></option> to
282 <command>configure</command>. Run <command>configure --help</command>
283 for all the available module names.</para>
284
285 </sect2>
286
287 <sect2 role="content">
288 <title>Contents</title>
289
290 <segmentedlist>
291 <segtitle>Installed Programs</segtitle>
292 <segtitle>Installed Libraries</segtitle>
293 <segtitle>Installed Directories</segtitle>
294
295 <seglistitem>
296 <seg>gst-launch-ext-0.8 and gst-visualise-0.8</seg>
297 <seg>libgst*.[so,a], numerous <application>GStreamer</application> plugins,
298 and a <application>Gstreamer</application> GDK pixbuf loader module</seg>
299 <seg>/etc/gnome/gconf/gconf.xml.defaults/schemas/system/gstreamer,
300 /etc/gnome/gconf/gconf.xml.defaults/system/gstreamer,
301 and many subdirs of /usr/include/gstreamer-0.8/gst</seg>
302 </seglistitem>
303 </segmentedlist>
304
305 <variablelist>
306 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
307 <?dbfo list-presentation="list"?>
308 <?dbhtml list-presentation="table"?>
309
310 <varlistentry id="gst-launch-ext">
311 <term><command>gst-launch-ext-0.8</command></term>
312 <listitem>
313 <para>is used to run a basic predefined
314 <application>GStreamer</application> pipeline as a quick test to ensure
315 proper working of codecs and <application>GStreamer</application>.</para>
316 <indexterm zone="gst-plugins gst-launch-ext">
317 <primary sortas="b-gst-launch-ext">gst-launch-ext-0.8</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="gst-visualise">
323 <term><command>gst-visualise-0.8</command></term>
324 <listitem>
325 <para>is used to run a basic <application>GStreamer</application>
326 pipeline to display a graphical visualisation of an audio stream.</para>
327 <indexterm zone="gst-plugins gst-visualise">
328 <primary sortas="b-gst-visualise">gst-visualise-0.8</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.