This directory contains the Sound Processing Kit software distribution.
Sound Processing Kit (abbr. SPKit) is a C++ class library for
audio signal processing.

The source code for the class library is in the spkit subdirectory.

The examples directory contains example programs and experimental classes.

The html directory contains documentation for the SPKit classes in HTML
format. The documentation is also available on-line via the Internet at
http://www.music.helsinki.fi/research/spkit.


COMPILING THE SPKIT CLASS LIBRARY

There are two versions of the SPKit library: a "generic" version, which
should compile and run on most UNIX compatible systems, and an SGI version,
which compiles and runs only on Silicon Graphics workstations. The generic version supports NeXT/Sun format soundfiles while the SGI version supports
AIFF/AIFC soundfiles. Both versions support only 16-linear sample
encoding with any sampling rate and any number of audio channels.
The two versions differ only in the implementation of the soundfile
I/O classes.

By default, the class library is configured for the generic version.
The default Makefile is for NEXTSTEP. To compile and install the class
library under NEXTSTEP, move to the spkit directory and type "make" or
"make install". On other platforms (e.g. SunOS) the Makefile must be
modified.

To configure and build the class library for Silicon Graphics workstations,
issue the following commands:

cd spkit
cp Makefile.sgi Makefile
cp reader.sgi.h reader.h
cp writer.sgi.h writer.h
make

The SGI Makefile is configured for GCC 2.0 or later.

There is also a Makefile for the Gnu C Compiler (named Makefile.gcc).
It should compile the generic version of the spkit library on most UNIX
platforms (including Sun) which have GCC 2.0 or newer installed.

When compiling on "little endian" machines, such as IBM PC compatibles
or DEC VAX, add the following line to the file machine.h in the
spkit directory:

#define __LITTLE_ENDIAN__

Under NEXTSTEP/Intel __LITTLE_ENDIAN__ is defined by default.


TESTED SYSTEMS

SPKit and (most of) the example programs have been compiled
successfully on the following systems.

Hardware:	NeXTstation
OS:		NEXTSTEP 3.3 User / 3.2 Developer
Compiler:	GCC 2.5.8 (as a replacement of the standard cc)
Makefile:	Makefile.next

Hardware:	Sun Sparc (several models)
OS:		SunOS 5.4
Compiler:	GCC 2.x (exact version unknown)
Makefile:	Makefile.gcc

Hardware:	HP 9000/735
OS:		HP-UX 9.01
Compiler:	GCC 2.x (exact version unknown)
Makefile:	Makefile.gcc

Hardware:	SGI Indy
OS:		IRIX 5.2
Compiler:	GCC 2.7.0
Makefile:	Makefile.sgi

