                        About SB_PAS v1.0
        
        This archive contains utilities for programming Sound Blaster
and compatible cards in Turbo Pascal. They were compiled with TP 7.0, but
should work with almost anything less. In writing SB_UNIT, I was able to
use only Pascal functions without inline assembly; not so lucky with
PLAY_VOC. 
        
        The routines are all fully commented with descriptions of the
steps required to perform each task. It should be *very* easy to port this
to other languages (like C <blech> ;-) ). 


Files contained in this package:
        SB_UNIT.PAS,TPU : Master unit for all functions - includes routines
                          for base address detection, direct port control,
                          and DMA transfers.

        PLAY_VOC,EXE : An example program to use SB_UNIT which demonstrates
                       the use of the unit as well as double-buffering
                       techniques.

        VOC-INFO.TXT : Some information about the .VOC file format (not
                       written by me).

        DMAPORTS.TXT : Some information about the DMA ports (again, not
                       written by me).

What's tested:
        All routines (except SB_SampleDMA, see below) work perfectly on my
        386/33 and Sound Blaster Pro CT-1330 - Base 220h, IRQ 5, DMA 1.
        Although I'm positive they will work on any configuration, I 
        suppose testing will be the ultimate judge...


Known bugs:
        1. The SB_SampleDMA procedure doesn't work. I have no idea why.
        2. Apparently .VOC files with sample rates > 22.05 kHz have a 
           different format for storing their sample rate. PLAY_VOC flags
           this format and displays an error message.
        
Future Additions:
        - Make SB_SampleDMA work.
        - Add mixer controls.
        - Maybe some interrupt-driven direct port routines.
        - IRQ/DMA detection.
        - Stereo and compression support, if I can find the information.
        

