mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-09-09 05:38:58 +00:00
139 lines
5.7 KiB
Text
139 lines
5.7 KiB
Text
WHAT IT IS
|
|
----------
|
|
This is gst-plugins, a set of plug-ins for GStreamer.
|
|
|
|
COMPILING FROM SOURCE
|
|
---------------------
|
|
- make sure you compiled and at least did a test-run of GStreamer (core)
|
|
- check output of ./configure --help to see if any options apply to you
|
|
- configure the source tree:
|
|
- if you installed GStreamer, then do:
|
|
./configure
|
|
If configure complains about missing GStreamer, you should try
|
|
./configure --with-pkg-config-path=prefix/lib/pkgconfig
|
|
where prefix should be replaced by the prefix you used to configure
|
|
GStreamer. (Be mindful NOT to ADD a trailing / to that option !)
|
|
If this doesn't fix it, you have other issues ;)
|
|
|
|
- if you didn't install GStreamer, you can still compile the plug-ins.
|
|
Add the path to gstreamer-uninstalled.pc (which lives in the gstreamer
|
|
source tree) to PKG_CONFIG_PATH
|
|
or run configure --with-pkg-config-path=(path to gstreamer uninstalled)
|
|
|
|
- the output of configure will give you a list of plug-ins with external
|
|
dependencies (ie, depending on other libs, see below). By no means
|
|
should you try to get them all built on your first run. This is hard
|
|
enough as it is ;) Resist the urge to get the most features for now.
|
|
It doesn't list all of the non-depending plug-ins, which get built
|
|
regardless (unless you explicitly asked it not to).
|
|
|
|
- build the tree:
|
|
make
|
|
If any plug-in causes a problem at this stage, you should re-configure
|
|
with --disable-(dependency)
|
|
and doublecheck if configure reports this plug-in as being disabled.
|
|
Then re-run make.
|
|
|
|
- install:
|
|
- if you installed GStreamer, and want to install the plug-ins as well, run
|
|
make install
|
|
and, as root, run
|
|
gst-register
|
|
- if you installed GStreamer, but don't want to install the plug-ins, run
|
|
gst-register --gst-plugin-path=.
|
|
- if you didn't install GStreamer, then do
|
|
path/to/gstreamer/tools/gst-register --gst-plugin-path=.
|
|
(Replace path/to/gstreamer obviously)
|
|
|
|
- test:
|
|
- run
|
|
gst-launch sinesrc ! fakesink
|
|
and prefix gst-launch with the path to gstreamer/tools if you didn't install
|
|
GStreamer.
|
|
If this doesn't give any errors, you can abort it.
|
|
|
|
- try replacing fakesink with your choice of
|
|
osssink/esdsink/artsdsink/alsasink/jacksink (depending on what output
|
|
method you have available) and see if you hear a C tone.
|
|
|
|
- After this, you should look into installing an application, like
|
|
gst-player, gst-editor or monkey-media with rhythmbox.
|
|
|
|
COMPILING FROM CVS
|
|
------------------
|
|
When building from CVS sources, you will need to run autogen.sh to generate
|
|
the build system files.
|
|
|
|
GStreamer is cutting-edge stuff. To be a CVS developer, you need
|
|
what used to be considered cutting-edge tools.
|
|
|
|
ATM, most of us have at least these versions :
|
|
|
|
* autoconf 2.52 (NOT 2.52d)
|
|
* automake 1.5
|
|
* libtool 1.4 (NOT Gentoo's genetic failure 1.4.2)
|
|
* pkg-config 0.8.0
|
|
|
|
autogen.sh will check for these versions and complain if you don't have
|
|
them. You can also specify specific versions of automake and autoconf with
|
|
--with-automake and --with-autoconf
|
|
|
|
Check autogen.sh options by running autogen.sh --help
|
|
|
|
autogen.sh can pass on arguments to configure - you just need to separate them
|
|
from autogen.sh with -- between the two.
|
|
prefix has been added to autogen.sh but will be passed on to configure because
|
|
some build scripts like that.
|
|
You will probably have to pass at least --with-pkg-config-path to autogen.sh
|
|
to point to the CVS version of GStreamer.
|
|
|
|
When you have done this once, you can use autoregen.sh to re-autogen with
|
|
the last passed options as a handy shortcut. Use it.
|
|
|
|
After the autogen.sh stage, you can follow the directions listed in
|
|
"COMPILING FROM SOURCE"
|
|
|
|
|
|
PLUG-IN DEPENDENCIES AND LICENSES
|
|
---------------------------------
|
|
GStreamer is developed under the terms of the LGPL (see LICENSE file for
|
|
details). Some of our plug-ins however rely on libraries which are available
|
|
under other licenses. This means that if you are using an application which
|
|
has a non-GPL compatible license (for instance a closed-source application)
|
|
with GStreamer, you have to make sure not to use GPL-linked plug-ins.
|
|
When using GPL-linked plug-ins, GStreamer is for all practical reasons
|
|
under the GPL itself.
|
|
|
|
The plug-ins which use a GPL library are as follows:
|
|
cdparanoia libcdparanoia (http://www.xiph.org/paranoia/)
|
|
aasink aalib (http://aa-project.sourceforge.net/aalib/)
|
|
xmms libxmms (http://www.xmms.org)
|
|
decdvd ac3dec,mpeg2dec (http://linuxvideo.org/mpeg2dec/,http://linuxvideo.org/ac3dec/)a
|
|
mad mad (http://www.mars.org/home/rob/proj/mpeg/)
|
|
|
|
Plug-ins which use an LGPL library are as follows:
|
|
colorspace Hermes (http://www.clanlib.org/hermes/)
|
|
httpsrc libghttp (ftp.gnome.org/pub/GNOME/stable/sources/libghttp/)
|
|
alsasink alsa (http://alsa-project.org)
|
|
arts aRts (http://arts-project.org)
|
|
sdlsink libsdl (http://www.libsdl.org)
|
|
gnomevfssource gnome-vfs (ftp.gnome.org//pub/GNOME/stable/sources/gnome-vfs)
|
|
gnomevfssink gnome-vfs
|
|
esdsink libesd (ftp.gnome.org/pub/GNOME/stable/sources/esound)
|
|
icastsend libshout (http://www.icecast.org)
|
|
lame libmp3lame (http://www.mp3dev.org/mp3/)
|
|
gst1394 libraw1394 (http://linux1394.sourceforge.net)
|
|
flac libFLAC (http://flac.sourceforge.net)
|
|
RTP ortp (http://www.linphone.org/ortp/)
|
|
|
|
Plug-ins which use a BSD covered library are as follows:
|
|
vorbisenc libogg/libvorbis (http://www.xiph.org/ogg/vorbis)
|
|
vorbisdec libogg/libvorbis
|
|
|
|
Plug-ins based on libraries with other free licenses:
|
|
xvideosink libXv (MIT X11 / X Consortium license)
|
|
gsm libgsm (MIT license http://kbs.cs.tu-berlin.de/~jutta/toast.html)
|
|
|
|
Plug-ins using non-free libraries:
|
|
wincodec win32ddl (http://divx.euro.ru/)
|
|
|