                   SBDRV Sound Blaster Driver Library V1.2
                   =======================================
                               January 12, 1998
                 by Ron Fries, Neil Bradley and Bradford Mott
                              
The SBDRV Library consists of source code and example executables that are 
designed to drive audio output through a sound blaster or compatible card.
The routines will support almost all sound cards and most compilers.  
Contained in this distribution, you should also have the following files:


SBDRVTST.TXT - This file
FILE_ID.DIZ  - A quick description of the release.
SBDRV.C      - The SB Driver Source Code.
SBDRV.H      - The SB Driver Header File which contains the function 
               prototypes.
SBDRV.TXT    - A text file which explains the operation of the SB Driver 
               module.
SBDRVTST.C   - The Main Test routine Source Code.  Provided as an example
               of how the routines can be used. 
SBDRVTST.EXE - An pre-compiled executable based on the code provided. 
CHIMES.RAW   - A raw 8-bit sample for the SBDRV example program.             


These routines are available for your use free of charge, provided you give 
us proper recognition and don't make a profit off of our work.  See the GNU 
Library Public License for more information.

If the final product you are creating will be sold for a profit, please
contact either Ron Fries at rfries@frmail.frco.com, Neil Bradley at
neil@synthcom.com or Bradford Mott at bmott@eos.ncsu.edu so we can discuss 
terms.


THE LIBRARY
-----------

The SBDRV Sound Blaster Driver Library consists of one main file.  This file
contains the all of the driver functions for the SB.  The only function this
file does *NOT* contain is the actual audio processing routine.  This makes
the functions generic enough to support most applications.

The SBDRV library is designed to support multiple compilers including both
16-bit and 32-bit varieties.  Most of this is accomplished through 
pre-processor definitions and context switches.  It has currently been 
tested with Borland C++ 3.51, MSVC 1.5x, WATCOM 10.6 and DJGPP.  If you find
another compiler already supported, please e-mail either Ron, Neil or Bradford.
Likewise, if you find a compiler that is currently not supported but
understand the modifications required, please forward those to us and we'll
integrate them into our next release.

The SBDRVTST.C file has also been provided as an example.  It was written 
mainly for testing, but should provide some insight on how to correctly
use the routines.  

The example routine provided reads a raw input file 'CHIMES.RAW'.  It provides
a simple mixing routine that allows the raw data to be played in either a 
single output mode or in looped mode.  The output can also be stopped or 
restarted, and the DMA mode can be changed between STANDARD and AUTO-INIT.

For the SBDRV routines to work correctly, the BLASTER environment variable 
must be configured.  Because only the low-speed audio output mode is
supported, the maximum playback frequency is approximately 22kHz.

License Information and Copyright Notice
========================================

SBDRV is Copyright(c) 1997-1998 by Ron Fries, Neil Bradley and Bradford Mott

This library is free software; you can redistribute it and/or modify it under 
the terms of version 2 of the GNU Library General Public License as published 
by the Free Software Foundation.

This library is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
FOR A PARTICULAR PURPOSE.  See the GNU Library General Public License for more 
details.

To obtain a copy of the GNU Library General Public License, write to the Free 
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Any permitted reproduction of these routines, in whole or in part, must bear 
this legend.  
