gstreamer/README
Wim Taymans c10560ebec Backporting some HEAD changes, mostly docs and stuff.
Original commit message from CVS:
Backporting some HEAD changes, mostly docs and stuff.
2005-03-08 14:27:43 +00:00

72 lines
2.3 KiB
Text

WHAT IT IS
----------
This is GStreamer, a framework for streaming media. The
fundamental design comes from the video pipeline at Oregon Graduate
Institute, as well as some ideas from DirectMedia. It's based on plug-ins
that will provide the various codec and other functionality. The
interface hopefully is generic enough for various companies (ahem, Apple)
to release binary codecs for Linux, until such time as they get a clue and
release the source.
COMPILING FROM SOURCE
---------------------
- check output of ./configure --help to see if any options apply to you
- run
./configure
make
to build GStreamer.
- if you want to install it (not required), run
make install
- You should create a registry for things to work.
If you ran make install in the previous step, run
gst-register
as root.
If you didn't install, run
tools/gst-register
as a normal user.
- try out a simple test:
gst-launch fakesrc num_buffers=5 ! fakesink
(If you didn't install GStreamer, again prefix gst-launch with tools/)
If it outputs a bunch of messages from fakesrc and fakesink, everything is
ok.
- After this, you're ready to install gst-plugins, which will provide the
functionality you're probably looking for by now, so go on and read
that README.
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.
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"