TVoice - The VOC Player C++ Class Library
=========================================
Quick Start Guide


Welcome, my fellow programmer, to the world of sound programming.
This manual gives the beginner C++ programmer a brief explanation
of TVoice and a "skeleton" program with which to work and add on
to.


What is TVoice?
===============
Good question.  TVoice is what is known as a C++ class, which is a
program element that contains variables and functions.  TVoice is
a class specialized for playing digital sound files on a Sound 
Blaster or Compatible.  These files must be in the VOC format.

Programming TVoice
==================
Programming TVoice is simple.  All you must do is declare a TVoice
object just like another variable, except you supply arguments to
the declaration - namely the DOS CT-VOICE driver name and full path,
and the name of the VOC file you wish to play, including the appropriate
DRV or VOC extentions.  Then, simply call the TVoice object's Play()
member function and set up a proper delay for the sound to finish
using the Wait() member function.  Or, you can set up a while loop
to check for a return value from the GetStatus member function.  This
will return a value other than the constant VOC_STATUS_STOPPED while
playing.

Sample Program
==============
The following is a "skeleton" TVoice program which you are free to 
customize to your needs.  In it, the driver name is assumed to be
"CT-VOICE.DRV" and the VOC file name is assumed to be "MYVOC.VOC".

   #include "tvoice.h"

   void main() {
      TVoice Digital ( "ct-voice.drv", "myvoc.voc" );
      Digital.Play();
      Digital.Wait();
   }

The program will end when the sound has finished playing.  Notice, the 
program itself consisted of only 7 lines!  Of course, this is the raw
minimum TVoice program, but you can build from this to make your own.

Refer to the file TVOICE.DOC for details on how to compile this program.

I hope you create wonderful programs with TVoice.  Most of all, have fun!





Sound Blaster is a registered trademark of Creative Technologies, LTD.
