Changeset a16e2c0c


Ignore:
Timestamp:
01/28/2006 10:00:04 PM (16 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
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
Children:
1ee90b5
Parents:
7f9e5aa
Message:

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

Files:
2 edited

Legend:

Unmodified
Added
Removed
  • introduction/welcome/changelog.xml

    r7f9e5aa ra16e2c0c  
    4646      <itemizedlist>
    4747        <listitem>
     48          <para>[randy] - Updated numerous items in the GStreamer Plug-ins
     49          instructions.</para>
     50        </listitem>
     51        <listitem>
    4852          <para>[andy] - Updated GConf to 2.12.1</para>
    4953        </listitem>
  • multimedia/libdriv/gst-plugins.xml

    r7f9e5aa ra16e2c0c  
    99<!ENTITY gst-plugins-md5sum        "ea787eeed3761ff03cb60ecebebe1c30">
    1010<!ENTITY gst-plugins-size          "2.4 MB">
    11 <!ENTITY gst-plugins-buildsize     "up to 107 MB (depends on what dependencies are installed)">
     11<!ENTITY gst-plugins-buildsize     "up to 109 MB (depends on what dependencies are installed)">
    1212<!ENTITY gst-plugins-time          "up to 3.6 SBU">
    1313]>
     
    3939    modules that can be built, providing <application>GStreamer</application>
    4040    the capability to create a pipeline for almost every known media
    41     stream.</para>
     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>
    4246
    4347    <bridgehead renderas="sect3">Package Information</bridgehead>
     
    8791    <xref linkend="libpng"/>,
    8892    <xref linkend="NASM"/>,
    89     <xref linkend="pango"/> and
     93    <xref linkend="pango"/>, and
    9094    X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
    9195
     
    9498    <xref linkend="arts"/>,
    9599    <xref linkend="audiofile"/>,
    96     <ulink url="https://cvs.comedi.org/cgi-bin/viewcvs.cgi/audioresample/">audioresample</ulink>,
     100    <ulink url="http://www.comedi.org/cgi-bin/viewcvs.cgi/audioresample/">audioresample</ulink>,
    97101    <xref linkend="esound"/>,
    98102    <ulink url="http://sourceforge.net/projects/faac">FAAC</ulink>,
     
    123127    <xref linkend="speex"/>,
    124128    <ulink url="http://www.theora.org/">Theora</ulink>,
    125     <ulink url="http://www.xiph.org/ogg/vorbis/index.html">Tremor</ulink>,
    126     <ulink url="http://www.wavpack.com/">WavPack</ulink> and
     129    <ulink url="http://www.xiph.org/vorbis/">Tremor</ulink>,
     130    <ulink url="http://www.wavpack.com/">WavPack</ulink>, and
    127131    <ulink url="http://developers.videolan.org/x264.html">x264</ulink></para>
    128132
     
    137141    <xref linkend="libfame"/>,
    138142    <xref linkend="libmpeg2"/>,
    139     <ulink url="https://cvs.comedi.org/cgi-bin/viewcvs.cgi/librfb/">librfb</ulink>,
     143    <!-- <ulink url="https://cvs.comedi.org/cgi-bin/viewcvs.cgi/librfb/">librfb</ulink>, -->
    140144    <ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
    141     <ulink url="http://www.thedirks.org/v4l2/">V4L2</ulink> and
     145    <ulink url="http://www.thedirks.org/v4l2/">V4L2</ulink>, and
    142146    <xref linkend="xvid"/></para>
    143147
     
    146150    <ulink url="http://sourceforge.net/projects/libvisual/">libvisual</ulink>,
    147151    <xref linkend="sdl"/>,
    148     <ulink url="http://swfdec.sourceforge.net/">swfdec</ulink> and
     152    <ulink url="http://swfdec.sourceforge.net/">swfdec</ulink>, and
    149153    <xref linkend="xine-lib"/></para>
    150154
     
    157161    following commands:</para>
    158162
    159 <screen><userinput>sed -i 's|LIBS="-lGLU|LIBS="-L/usr/X11R6/lib -lGLU|' configure &amp;&amp;
     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
    160169./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
    161170make</userinput></screen>
     
    163172    <para>To check the results, issue:</para>
    164173
    165 <screen><userinput>gst-register &amp;&amp;
    166 make check</userinput></screen>
    167 
    168     <para> On some platforms in certain situations the tests will fail. This
    169     issue has been reported upstream.</para>
     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>
    170192
    171193    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    172194
    173195<screen role="root"><userinput>make install &amp;&amp;
    174 gst-register</userinput></screen>
     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>
    175239
    176240  </sect2>
     
    179243    <title>Command Explanations</title>
    180244
    181     <para><command>sed -i '...' configure</command>: The check for the OpenGL
    182     (Mesa) libraries will fail because the proper directory is not included in
    183     the search path. This command fixes the problem.</para>
     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>
    184256
    185257    <para><option>--with-gconf-schema-file-dir=/etc/gnome/gconf/schemas</option>:
     
    193265    <para><option>-enable-xine</option>: Use this option to build the
    194266    <application>Xine</application> wrapper module if you have the
    195     <application>Xine Libraries</application> package installed.</para>
     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>
    196270
    197271    <!--
Note: See TracChangeset for help on using the changeset viewer.