                         Portable Sound Library

This directory contains a library of C routines to support
Sound effects to your programs in an easy way.

Programs using this routines have to 

#include <sndlib.h>

and must be linked using the

-lsound

library.


=========================================================================

1. Background Sound player by Kurt Siegl <siegl@risc.uni-linz.ac.at>

This are the routines using a background player for soundeffects.

Features:

  Runs and plays independent from the main program.
  Constantly opens the audio device, to avoid a nasty click sound.
  Best suited for including realtime sound effects to games or
  other programs.


Usage:

InitSound();

   Starts the Background Sound player
   Returns:  0 on succes
            -1 in case of an error

ExitSound();

   Terminates and cleans up the Background Sound player.


StartSound(char *SoundFile);

   Plays an Sound File in the Background.


StopSound();

   Aborts the currently played Sound.


Configuration:

   The type of the audiodevice, as well as the used parameters must be
   changed in the sndconfig.h before installing the library.

   Default: 8000 Hz 8 bit mono SUN (/dev/audio) sound.

 
Note:

   Programs using this library require the "bpsndplay" program in a directory
   included in your PATH.


Problems:

   StopSound may have up 2 seconds delay.
   Same if you start a new sound effect, while an old one is still playing.

   Static configuration of the sound type only.


Send bug reports suggestions to Kurt Siegl <siegl@risc.uni-linz.ac.at>

===========================================================================

2. Other Sound Tools

There is room for including your tools to the library.
Start writing on them.

