General Information
===================

gstreamermm provides C++ bindings for the GStreamer streaming multimedia
library (http://gstreamer.freedesktop.org).  With gstreamermm it is possible to
develop applications that work with multimedia in C++.

gstreamermm is developed over glibmm, libsigc++ and libxml++ and the
functionalities they provide.  This means that, among other things, referencing
and unreferencing of GObjects is handled automatically via glibmm's automatic
pointer class, Glib:RefPtr<>, and libsigc++'s slots are used for callbacks and
signals.

There are several examples, including a media player, in the examples/
directory, that demonstrate how to use the API and there are API docs in the
docs/reference/html directory.  The core plug-ins, such as Gst::Identity and
Gst::FileSrc are also provided along with many of the base plug-ins.

Dependencies
============

gstreamermm requires glibmm >= 2.18.1 and libxml++ >= 2.14.0 along with the
libraries that these require.  For the examples, gtkmm >= 2.12 is also
required.

Build Dependencies
==================

To build gstreamermm from git (not from tarballs), many gstreamer plug-ins must
be available. If you also built gstreamer and gst-plugins-good from source then
you must have the correct libraries installed when building them.

For instance on debian/Ubuntu, apt-get install:
libvorbis-dev, libtheora-dev, libasound-dev, libxv-dev, libvisual-0.4-dev,
libcdparanoia-dev

You will also need to use --enable-experimental when building gst-plugins-base,
to build the giosink plug-in.

Links
=====

git:
  git://git.gnome.org/gstreamermm
  http://git.gnome.org/cgit/gstreamermm/
  (It's in jhbuild)
download:
  http://ftp.gnome.org/pub/GNOME/sources/gstreamermm/
submit bugs: 
  http://bugzilla.gnome.org/enter_bug.cgi?product=gnomemm&component=gstreamermm
view bugs:
  http://bugzilla.gnome.org/buglist.cgi?query=component%3Agstreamermm+product%3Agnomemm+


Installation
============

See the 'INSTALL' file.
