Beyond Linux® From Scratch - Version 7.5

Chapter 39. Multimedia Libraries and Drivers

GStreamer-0.10.36

Introduction to GStreamer

GStreamer is a streaming media framework that enables applications to share a common set of plugins for things like video decoding and encoding, audio encoding and decoding, audio and video filters, audio visualisation, Web streaming and anything else that streams in real-time or otherwise. It is modelled after research software worked on at the Oregon Graduate Institute. After installing GStreamer, you'll likely need to install one or more of the gst-plugins-bad-0.10.23, gst-plugins-good-0.10.31, gst-plugins-ugly-0.10.19 and gst-ffmpeg-0.10.13 packages.

This package is known to build and work properly using an LFS-7.5 platform.

[Note]

Note

GStreamer 1.0 series is not API or ABI compatible with GStreamer 0.10 series and both can be installed on the same system.

Package Information

GStreamer Dependencies

Required

GLib-2.38.2 and libxml2-2.9.1

Optional (Required if building GNOME)

gobject-introspection-1.38.0

Optional

Gsl-1.16, Valgrind (optionally used during the unit regression tests)

Optional (Required to rebuild the API Documentation)

GTK-Doc-1.19 and Python-2.7.6 (compiled against an XML Parser such as expat-2.1.0).

Optional (Required to Build Manuals)

DocBook-utils-0.6.14, ghostscript-9.10 libxslt-1.1.28 and texlive-20130530

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gstreamer

Installation of GStreamer

Install GStreamer by running the following commands: 

sed -i  -e '/YYLEX_PARAM/d'                                       \
        -e '/parse-param.*scanner/i %lex-param { void *scanner }' \
            gst/parse/grammar.y &&

./configure --prefix=/usr \
            --disable-static &&
make

To test the results, issue: make check. There are many other Makefile targets you can specify for running the tests, issue make -C tests/check help to see the complete list.

Now, as the root user: 

make install &&
install -v -m755 -d /usr/share/doc/gstreamer-0.10/design &&
install -v -m644 docs/design/*.txt \
                    /usr/share/doc/gstreamer-0.10/design &&

if [ -d /usr/share/doc/gstreamer-0.10/faq/html ]; then
    chown -v -R root:root \
        /usr/share/doc/gstreamer-0.10/*/html
fi

Testing the Installation

To test the functionality of the GStreamer installation, you can run a simple test as an unprivileged user (you may have to run ldconfig as the root user before attempting the test). 

gst-launch -v fakesrc num_buffers=5 ! fakesink

If the command outputs a series of messages from fakesrc and fakesink, everything is okay.

Command Explanations

sed ... gst/parse/grammar.y: This command corrects a problem caused by the most recent version of Bison.

--disable-static: This switch prevents installation of static versions of the libraries.

--enable-gtk-doc: Use this parameter if GTK-Doc is installed and you wish to rebuild and install the API documentation.

--enable-docbook: This parameter is used to build HTML, PDF and PostScript versions of the GStreamer User's Manual, FAQ and Writer's Guide. Note that you must have all the listed dependencies installed.

chown -v -R root:root ...: The documentation is installed with the ownership of the user who untarred and built the package. This command changes the ownership of the installed documentation files to root:root, and is only executed if the documentation files were built and installed.

--libexecdir=/usr/lib: This option puts the internal support programs into /usr/lib/gstreamer-0.10 instead of /usr/libexec/gstreamer-0.10. in accordance with the old version of the FHS used before LFS-7.5.

Contents

Installed Programs: gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10, gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10, gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and gst-xmllaunch-0.10
Installed Libraries: libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so, libgstdataprotocol-0.10.so, libgstnet-0.10.so and libgstreamer-0.10.so
Installed Directories: /usr/include/gstreamer-0.10, /usr/lib/gstreamer-0.10, /usr/libexec/gstreamer-0.10, /usr/share/gtk-doc/html/gstreamer-0.10, /usr/share/gtk-doc/html/gstreamer-libs-0.10 and /usr/share/gtk-doc/html/gstreamer-plugins-0.10

Short Descriptions

gst-feedback-0.10

generates debug info for GStreamer bug reports.

gst-inspect-0.10

prints information about a GStreamer plugin or element.

gst-launch-0.10

is a tool that builds and runs basic GStreamer pipelines.

gst-typefind-0.10

uses the GStreamer type finding system to determine the relevant GStreamer plugin to parse or decode a file, and determine the corresponding MIME type.

gst-xmlinspect-0.10

prints information about a GStreamer plugin or element in XML document format.

gst-xmllaunch-0.10

is used to build and run a basic GStreamer pipeline, loading it from an XML description.

Last updated on 2014-03-03 19:06:31 -0800