glfs/multimedia/libdriv/gst10-plugins-bad.xml
Douglas R. Reno 4ef9eb3bce Minor tweaks to the gstreamer section:
gst-plugins-good: Remove the libtool caution, we're using meson/ninja now so it no longer applies
gst-plugins-*: Convert the 'dependency for a given plugin needs to be installed first' into an XInclude
gst-*: With the move to Meson, the developers put in a sanity check to ensure that there is an ObjC compiler on the system. This was originally intended for macOS, and the build continues normally without it. I've added an XInclude containing a note to all pages affected to document this, since it describes itself as a 'fatal error'

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21627 af4574ff-66df-0310-9fd7-8a98e5e911e0
2019-05-26 20:07:26 +00:00

245 lines
8.3 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gst10-plugins-bad-download-http
"&gstreamer-dl;/gst-plugins-bad/gst-plugins-bad-&gst10-plugins-bad-version;.tar.xz">
<!ENTITY gst10-plugins-bad-download-ftp " ">
<!ENTITY gst10-plugins-bad-md5sum "e9e562d86c1527c44d904500dd35e326">
<!ENTITY gst10-plugins-bad-size "4.6 MB">
<!ENTITY gst10-plugins-bad-buildsize "83 MB (with tests)">
<!ENTITY gst10-plugins-bad-time "0.4 SBU (Using parallelism=4; with tests)">
]>
<sect1 id="gst10-plugins-bad" xreflabel="gst-plugins-bad-&gst10-plugins-bad-version;">
<?dbhtml filename="gst10-plugins-bad.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>gst-plugins-bad-&gst10-plugins-bad-version;</title>
<indexterm zone="gst10-plugins-bad">
<primary sortas="a-gst-plugins-bad">gst-plugins-bad</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GStreamer Bad Plug-ins</title>
<para>
The <application>GStreamer Bad Plug-ins</application> package contains a
set of plug-ins that aren't up to par compared to the rest. They
might be close to being good quality, but they're missing something - be
it a good code review, some documentation, a set of tests, a real live
maintainer, or some actual wide use.
</para>
&lfs84_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&gst10-plugins-bad-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&gst10-plugins-bad-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &gst10-plugins-bad-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &gst10-plugins-bad-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &gst10-plugins-bad-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &gst10-plugins-bad-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GStreamer Bad Plug-ins Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="gst10-plugins-base"/>
</para>
<!-- Common formats, output and input codecs and requirements
for GNOME apps. What's a multimedia framework useful if it
can't be used to play anything (common)? -->
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="libdvdread"/>,
<xref linkend="libdvdnav"/>,
<xref linkend="llvm"/>, and
<xref linkend="soundtouch"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="bluez"/>,
<xref linkend="clutter"/>,
<xref linkend="curl"/>,
<xref linkend="faac"/>,
<xref linkend="faad2"/>,
<xref linkend="fdk-aac"/>,
<xref linkend="gnutls"/>,
<xref linkend="gtk-doc"/>,
<xref linkend="gtk2"/> or
<xref linkend="gtk3"/>,
<xref linkend="lcms2"/>,
<xref linkend="libass"/>,
<xref linkend="libexif"/>,
<xref linkend="libgcrypt"/>,
<xref linkend="libgudev"/>,
<xref linkend="libmpeg2"/>,
<xref linkend="libssh2"/>,
<xref linkend="libusb"/>,
<xref linkend="libvdpau"/>,
<xref linkend="libwebp"/>,
<xref linkend="neon"/>,
<xref linkend="nettle"/>,
<xref linkend="opencv"/> (with additional modules),
<xref linkend="openjpeg2"/>,
<xref linkend="opus"/>,
<xref linkend="qt5"/> (for examples),
<xref linkend="sdl"/>,
<xref linkend="valgrind"/>,
<xref linkend="wayland"/> (<xref linkend="gtk3"/> must have been
compiled with wayland support),
<xref linkend="x265"/>,
<xref linkend="xorg7-lib"/>,
<ulink url="http://bs2b.sourceforge.net/">bs2b</ulink>,
<ulink url="https://acoustid.org/chromaprint">Chromaprint</ulink>,
<ulink url="https://www.xiph.org/daala/">daala</ulink>,
<ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
<ulink url="https://bitbucket.org/mpyne/game-music-emu/">Game Music Emu</ulink>,
<ulink url="http://www.quut.com/gsm/">GSM</ulink>,
<ulink url="https://www.ladspa.org/">LADSPA</ulink>,
<ulink url="http://sourceforge.net/projects/farsight/files/libmimic/">libmimic</ulink>,
<ulink url="http://sourceforge.net/projects/libmms/">libmms</ulink>,
<ulink url="http://code.google.com/p/musicip-libofa/">libofa</ulink>,
<ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
<ulink url="http://kcat.strangesoft.net/openal.html">OpenAL</ulink>,
<ulink url="http://gstreamer.freedesktop.org/src/orc/">Orc</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc/">VO AAC</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-amrwbenc/">VO AMRWB</ulink>, and
<ulink url="http://zbar.sourceforge.net/">ZBAR</ulink>
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/gst10-plugins-bad"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GStreamer Bad Plug-ins</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gst10-objc-error.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gst10-plugins.xml"/>
<para>
Install <application>GStreamer Bad Plug-ins</application> by running the
following commands:
</para>
<screen><userinput>mkdir build &amp;&amp;
cd build &amp;&amp;
meson --prefix=/usr \
-Dbuildtype=release \
-Dpackage-origin=http://www.linuxfromscratch.org/blfs/view/svn/ \
-Dpackage-name="GStreamer &gst10-plugins-bad-version; BLFS" &amp;&amp;
ninja</userinput></screen>
<para>
To test the results, issue: <command>ninja test</command>. Several tests
need a terminal emulator in a graphical session. One test, elements_dash_mpd,
is known to fail.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>ninja install</userinput></screen>
</sect2>
<!--
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<parameter>- -disable-wayland</parameter>: This switch is required
without a full wayland based desktop environment.
</para>
<para>
<parameter>- -disable-opencv</parameter>: This switch is required
if <xref linkend="opencv"/> is installed without additional modules
(specifically bgsegm).
</para>
</sect2>
-->
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
None
</seg>
<seg>
libgstadaptivedemux-1.0.so,
libgstbadaudio-1.0.so,
libgstbadvideo-1.0.so,
libgstbasecamerabinsrc-1.0.so,
libgstcodecparsers-1.0.so,
libgstinsertbin-1.0.so,
libgstisoff-1.0.so,
libgstmpegts-1.0.so,
libgstphotography-1.0.so,
libgstplayer-1.0.so,
libgsturidownloader-1.0.so,
libgstwayland-1.0.so,
libgstwebrtc-1.0.so, and
several plugins under /usr/lib/gstreamer-1.0
</seg>
<seg>
/usr/include/gstreamer-1.0/gst/{audio,basecamerabinsrc,codecparsers},
/usr/include/gstreamer-1.0/gst/{insertbin,interfaces,is,mpegts},
/usr/include/gstreamer-1.0/gst/{player,uridownloader,video,webrtc},
/usr/lib/gstreamer-1.0/include, and
/usr/share/gtk-doc/html/gst-plugins-bad-{libs,plugins}-1.0
</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>