gstreamer/ext/audiofile
Ronald S. Bultje d9e4457faa 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:14:50 +00:00
..
gstaf.c - Changed plugins for new APIs 2002-05-26 21:59:21 +00:00
gstafparse.c 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:14:50 +00:00
gstafparse.h 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:14:50 +00:00
gstafsink.c reverting error patch before making a branch. 2003-09-16 10:00:00 +00:00
gstafsink.h - Changed plugins for new APIs 2002-05-26 21:59:21 +00:00
gstafsrc.c reverting error patch before making a branch. 2003-09-16 10:00:00 +00:00
gstafsrc.h - Changed plugins for new APIs 2002-05-26 21:59:21 +00:00
gstaftypes.c Add buffer length checks to every typefinding function 2003-07-24 08:49:43 +00:00
Makefile.am Remove redundant plugindir definition 2003-08-10 00:01:58 +00:00
README fixed some GST_LIBS stuff added audiofile added gst-libs/audio building 2001-12-21 11:46:15 +00:00

This plugin wraps the SGI Audiofile 
(http://oss.sgi.com/projects/audiofile/) library into a src and sink
element.

You can read from and write to the supported formats (WAVE, AIFF, AIFFC,
NEXTSND).

What is supported :
* all the file formats
* integer sample data, both 2's complement and unsigned
* 8 or 16 bit width & depth (haven't tested others)
* sample rate
* some sort of endianness control

What isn't supported yet :
* float data

What you can do :
* src element only accepts location argument
* sink element accepts location, endianness and type
	- location : file on the system to output
	- endianness : at this time endianness is still a bit shady
	  	you can either set 1234 or 4321;
		setting it to 4321 will byteswap the buffer data
		you might want to keep it at 1234 for now
	- type : one of the file types

Use gstreamer-inspect on afsink and afsrc to see all of the supported
options.

Examples :

* tools/gstreamer-launch afsrc location=/opt/media/wav/dark-480-16-m.wav ! afsink type=2 location=/opt/media/wav/dark-480-16-m.aiff

Future plans :

* add float support
* wrap up afsink and afsrc with pipe and fork to act like data convertors,
  allowing arbitrary choice of sink and src element