mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-08 18:39:54 +00:00
3081a40cc8
Original commit message from CVS: Update README to give valid PKG_CONFIG_PATH instructions
109 lines
4.4 KiB
Text
109 lines
4.4 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 the
|
|
following command:
|
|
$export 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 !).
|
|
After that, rerun ./configure. 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
|
|
* gettext 0.11.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.
|
|
|
|
There is a LICESENSE_readme file containing licensing information on the plugins
|