Copyright (C) 1994 Peter Kabal

The AFsp audio file routines are provided free of charge without warranty of
any kind.  All components are copyrighted.  They may be distributed free of
charge provided that the recipients also acquire the right to distribute them.
In no case can this software be incorporated into a work which is distributed
for a fee.

AFsp routines

These routines have been tested on DEC Ultrix mips systems using the mips
cc and gcc compilers, and on Sun Sparc machines running SunOs with the cc
and gcc compilers.

Building libtsp.a:
  After unpacking the sources, go into the libtsp directory.
  % cd libtsp
  % make
  This will build the library file lib/libtsp.a.

Building the utility programs:
  Return to the main directory, then go into the audio directory.
  % cd audio
  % make
  This makes the programs CompAudio, CopyAudio, FiltAudio and InfoAudio.

  These utilities have been built on the systems listed below.  Extensive
  testing has been carried out for only the first two configurations listed.
  - DEC Ultrix 4.2 running on a DECstation (mips cc and gcc compilers)
  - SunOS 4.1 running on a Sparc machine (cc and gcc compilers)
  - SunOS 5.3 (Solaris) running on a Sparc machine (cc and gcc compilers)
    One needs to link to libnsl (used to access the routine gethostname).  This
    is accomplished by adding "-lnsl" to the list of libraries in the Makefile
    for CopyAudio and FiltAudio.
  - OSF/1 V1.3 running on a DEC 3000 Model 300LX
    The Makefile for building libtsp.a does not work.  It will build the object
    files; these then have to be put into the archive manually.
  - HPUX 9.01 running on a HP 735 (cc compiler)

Test scripts:
  In the directory test, there is a test script which will exercise CopyAudio
  and CompAudio.  A sample output is in the file tCopyAudio.log.  Also in
  the directory test, there is a test script which will exercise FiltAudio.
  A sample output is in the file tFiltAudio.log.

Audio files:
  A number of audio files of various formats can be found in the
  test/audiofiles directory.  Running InfoAudio on these should provide
  information as to the format of these files.

Using the library routines:
  To use the AFsp routines for reading and writing audio files, you will have
  to link with the library.  Furthermore, user programs need access to the
  header file libtsp.h.  I suggest putting libtsp.a (or a link to it) in
  /usr/local/lib and libtsp.h (or a link to it) in /usr/local/include.

  Documentation for the audio file library routines is in the header of the
  appropriate routine.  You will notice that many routines are hidden one level
  down in a "nucleus" directory.  These are internal routines usually not of
  interest directly to the end user.  For simple audio file I/O, only
  AFopenRead, AFopenWrite, AFclose, AFreadData, and AFwriteData need be used.
  Several auxiliary routines (AFsetNH, AFsetHinfo, FLpathList for example)
  can be used to make the audio file routines more flexible.  See the source
  file for CopyAudio for examples of how to allow for user specified parameters
  for headerless input files, user supplied header information strings and
  flexible path searching.

  The header files in the include/libtsp directory are used to define internal
  data structures.  While not usually used directly by the end user, these
  header files should be available, particularly for rebuilding the library.
  For this reason, these might find a home in /usr/local/include/libtsp.

$Id: INSTALL,v 1.4 1994/02/23 AFsp-V1R2 $
