GStreamer multimedia framework
Find a file
Ronald S. Bultje 6fbff1c106 New typefind system: bytestream is now part of the core all plugins have been modified to use this new typefind syste...
Original commit message from CVS:
New typefind system:
* bytestream is now part of the core
* all plugins have been modified to use this new typefind system
* asf typefinding added
* mpeg video stream typefiding removed because it's broken
* duplicate typefind entries removed
* extra id3 typefinding added, because we've seen 4 types of files
(riff/wav, flac, vorbis, mp3) with id3 headers and each of these needs
to work. Instead, I've added an id3 element and let it redo typefiding
after the id3 header. this needs a hack because spider only typefinds
once. We can remove this hack once spider supports multiple typefinds.
* with all this, mp3 typefinding is semi-rewritten
* id3 typefinding in flac/vorbis is removed, it's no longer needed
* fixed spider and gst-typefind to use this, too.
* Other general cleanups
2003-10-01 13:11:45 +00:00
common@b7abb510aa Updated some signal descriptions, added some full stops and fixed some typos 2003-09-26 11:54:40 +00:00
components changed libgst -> libgstreamer to comply with namespace issues with gnu smalltalk various other fixes 2002-02-10 17:09:53 +00:00
debian commiting Leifs registry to /var/cache patch, works well for me :) 2002-11-28 13:29:52 +00:00
docs New typefind system: bytestream is now part of the core all plugins have been modified to use this new typefind syste... 2003-10-01 13:11:45 +00:00
examples ignore 2003-09-11 12:13:56 +00:00
gst New typefind system: bytestream is now part of the core all plugins have been modified to use this new typefind syste... 2003-10-01 13:11:45 +00:00
include removal of //-style comments don't link plugins to core libs -- the versioning is done internally to the plugins with... 2002-03-19 04:10:13 +00:00
libs New typefind system: bytestream is now part of the core all plugins have been modified to use this new typefind syste... 2003-10-01 13:11:45 +00:00
pkgconfig ignore .pc files 2003-04-27 06:20:44 +00:00
plugins make filesink handle events only in the chainfunction 2003-09-30 13:11:44 +00:00
po feeble attempt at translating a few messages 2003-08-17 22:30:59 +00:00
scripts check out cvs code, autogen, make, make distcheck if you have spare machines at work sitting idly during the night, r... 2001-12-14 09:44:11 +00:00
tests ignore these test code 2003-09-11 12:19:22 +00:00
testsuite ignore these test code 2003-09-11 12:19:22 +00:00
tools Update the documentation here too to include more details on --gst-debug 2003-09-29 22:02:41 +00:00
.gitignore ignore these test code 2003-09-11 12:19:22 +00:00
.gitmodules Added a first stab at a better clocking system. 2002-02-03 20:07:09 +00:00
ABOUT-NLS added blank file to keep autoconf happy, fill it in later 2001-05-28 19:59:25 +00:00
AUTHORS added myself 2001-12-12 23:45:40 +00:00
autogen.sh Remove running configure for cothreads, since it's been removed. 2003-08-23 01:09:23 +00:00
ChangeLog I'm too lazy to comment this 2003-06-02 06:33:08 +00:00
configure.ac New typefind system: bytestream is now part of the core all plugins have been modified to use this new typefind syste... 2003-10-01 13:11:45 +00:00
COPYING initial checkin 2000-01-30 09:03:00 +00:00
COPYING.LIB initial checkin 2000-01-30 09:03:00 +00:00
DEVEL more registry fixes 2002-04-12 18:50:48 +00:00
DOCBUILDING more docbuilding notes 2002-04-12 09:43:11 +00:00
gst-element-check.m4 Port some changes from 0.6.0/0.6.1 back to HEAD (.pc files moved to pkg-config/, .m4 file moved from plugins to core) 2003-04-07 21:28:57 +00:00
gst-element-check.m4.in Port some changes from 0.6.0/0.6.1 back to HEAD (.pc files moved to pkg-config/, .m4 file moved from plugins to core) 2003-04-07 21:28:57 +00:00
gstreamer.spec.in this contains fixed needed to once again build rpms of CVS head. It disables doc building, dists the po stuff (not th... 2003-08-19 18:25:53 +00:00
idiottest.mak idiottest was failing because of change of PLUGIN_USE_SRCDIR to 2001-06-19 12:53:05 +00:00
indent.pro This is an indent profile for the core coding style 2002-09-23 21:36:03 +00:00
INSTALL initial checkin 2000-01-30 09:03:00 +00:00
LICENSE Adding explicit license information, since quite a large number of source files don't have the LGPL header. This is ... 2000-08-05 03:53:00 +00:00
Makefile.am this contains fixed needed to once again build rpms of CVS head. It disables doc building, dists the po stuff (not th... 2003-08-19 18:25:53 +00:00
NEWS docs changes 2001-12-11 22:55:55 +00:00
README check 2003-08-05 10:40:51 +00:00
RELEASE merge back from release branch 2003-01-08 16:03:49 +00:00
REQUIREMENTS Automake-1.5 chokes on gst/Makefile.am, so updating requirement to 1.6. 2003-08-06 01:15:48 +00:00
stamp.h.in initial checkin 2000-01-30 09:03:00 +00:00
TODO update TODO 2003-02-12 23:33:55 +00:00

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"