FishSound, the sound of fish!
-----------------------------

  Full documentation is available in doc/fishsound/html/index.html,
  or online at http://www.annodex.net/software/libfishsound/html/

  Updates are available online at the FishSound homepage:
  http://www.annodex.net/software/libfishsound/

libfishsound provides a simple programming interface for decoding and
encoding audio data using Xiph.Org codecs (FLAC, Speex and Vorbis).

libfishsound by itself is designed to handle raw codec streams from a
lower level layer such as UDP datagrams. When these codecs are used in
files, they are commonly encapsulated in Ogg to produce Ogg FLAC, Speex
and Ogg Vorbis files.

libfishsound is a wrapper around the existing codec libraries and provides
a consistent, higher-level programming interface. It has been designed for
use in a wide variety of applications; it has no direct dependencies on
Ogg encapsulation, though it is most commonly used in conjunction with
liboggz to decode or encode FLAC, Speex or Vorbis audio tracks in Ogg files,
including Ogg Theora and Annodex.

This source tarball
-------------------

FishSound has been developed and tested on GNU/Linux, Darwin/MacOSX and
Win32. It probably also works on other Unix-like systems via GNU autoconf.
For Win32: nmake Makefiles, Visual Studio .NET 2003 solution files and
Visual C++ 6.0 workspace files are all provided in the source distribution.

Details for building with GNU autotools are in the file INSTALL. Read the
file README.win32 for installing under MS Windows.

  src/libfishsound/  the library source code.
  src/examples/      example tools for programming with libfishsound.

  include/           the libfishound include files that will be installed
                     into the system include directory.

  doc/               documentation for libfishsound. The subdirectory
                     doc/libfishsound is autocreated by doxygen from
		     comments contained in <fishsound/fishsound.h>

  win32/             files necessary to compile under MS Windows.

The /Win32 directory contains everything necessary to compile
libfishsound under windows and create:

- libfishsound.dll
- identify.exe
- encode.exe
- decode.exe

Building with the Makefile
==========================

Here's what you need to do:

1) Install libogg.dll, libvorbis.dll, and libspeex.dll.
   (you can get them from http://www.xiph.org/ogg/vorbis/
    and http://www.speex.org/ ). encode and decode will
   additionally require libsndfile to be installed (see
   http://www.mega-nerd.com/libsndfile/).

2) cd win32 subdirectory

3) Use "nmake" to create library and executable.

4) Install libfishsound.dll and the include files from the
   /include/fishsound/ directory.

5) You can test the library with the "identify.exe" program
   also found in the win32 subdirectory.


Visual Studio.NET 2003 Installation
===================================
NOTE: For lack of platform, we were not able to keep the solution
files up-to-date. Please use the Visual Studio Version 6 files
instead or send us an updated version if you're using these.


IMPORTANT: The solution files were built for VS.NET 2003 and can't be
opened by VS.NET 2002. If you use VS.NET 2002 you should use the VS6
workspace files and they will be automatically converted to the new
format.

Also included in the solution is a setup and deployment project that
will package and create an installer for the binary output of this
project.

You will need to install the libogg, libvoribs, and libspeex libraries
separately. If you wish to create a debug build and wish to have the
debugger load the symbols for these libraries, you should also include
their project source files. By default the compiler and linker will
look for them in the same parent directory as libfishsound. However
you can install them wherever you choose and must modify the include
directories for the linker and compiler in your projects properties.


Visual Studio Version 6 Installation
====================================

There is also a Visual C++ V 6.0 workspace file in the Win32 directory
in case you have not upgraded to Visual Studio.NET.