The Tools (V 1.3)
					      

                         Examples of Vroom-Diggy-Diggy
			 BLASTER.H and DIRECT.H Power


                           (c)1991 Vroom-Diggy-Diggy




The following descriptions of the included .exe are samples of the power
of the BLASTER.H and DIRECT.H interface.  You need know nothing about
programming to use the following programs.  Note Vroom-Diggy-Diggy is not
responsible for any damage or data loss caused by the below software.
In short, use at your own risk.


BLAST.EXE - a very powerful voice file player.
        Running blast with no parameters will give you a quick summary
        of the possible options. If you wish to use it in a no frills
        fashion, just give it the name of the voice file (include the
        path if it's not in the current directory including the extention),
        and away you go!

        Example:
            BLAST NELLAF.VOC

   Options Summary:

        /c="command" - Command Shell
             This can used to make interesting batch files and such.

        Example:
             BLAST VROOM.VOC /C="DEL *.*"

             This will play the sound VROOM.VOC, then delete everything
             in your current directory.


        /i="sound.voc" - Immediate Load Sound
             This is used for such things as loading the next sound while
             playing the current one.  This will save time and get rid of
             that silence between sounds.

        Example:
             BLAST /I="BEAM_DAF.VOC" /I="NELLAF.VOC" /C="CLS"

             This will load BEAM_DAF.VOC and begin playing it, then load
             NELLAF.VOC, wait until BEAM_DAF.VOC stops playing, play
             NELLAF.VOC, and clear the screen while playing NELLAF.VOC.


        /p="sound.voc" - Preload Sound
             This is used when you wish to play something immediately
             after doing something but don't want to wait for it to load.

        Example:
             BLAST /p="NELLAF.VOC" /C="PICEM E:\HGTTG.GIF /e"

             This will load NELLAF.VOC, display the gif, then play
             the sound.


        /b - Break
             This will force a break in the processing of the parameters
             and unload all the previously loaded sounds once they finish
             playing.  This feature enables one to play a large sound
             file that would normally need to be played alone, then do
             something else.




SHELL.EXE - a voice file player in a neat interface. Keyboard version.
        This program takes a maximum of 202 files in any directory.
        Do not exceed this number--we're not kidding.  The program will
        enable you to change directorys and disks.  This program will
        only works well with 80x25 in color.  (Monochrome users can not
        see the highlighter.)



SHELL2.EXE - a voice file player for people with a mouse.
        This program is similar to shell.exe, but all input is with
        the mouse. Beware, this program never looks at the keyboard!
        This program will only works well with 80x25 in color.  Again,
        monochrome users can not see the mouse pointer.

        Known bug:  if previously in 50 line mode, the mouse cursor will
        not be updated. You can avoid this by entering 25 line mode.



MIX.EXE - This program mixes two samples together. The sound files
        may be voice files or raw 8-bit files.  If one of them is a
        voice file, then its header will be used.  If both are voice
        files, then the header of the larger file will be used. Be
        careful that both file have the same sample rate.

        Example:
             MIX NELLAF.VOC VROOM.VOC OUTFILE.VOC
                 (source 1) (source 2) (target)



REVERSE.EXE - This program will reverse voice files. Exceptionly large
        files don't seem to work well, but we're working on it.

        Example:
             REVERSE NELLAF.VOC FALLEN.VOC
                     (source)   (target)



FREQ.EXE - This program will output a pure tone of a given frequency.
        What you can use it for we haven't figured out, but it's there.
        It will prompt you for the appropiate information.  Be forewarned,
        this does not output voice files, but 8-bit raw data. The header
        utility that comes with the Sound Blaster can be used to add a
        header.  We are currently working on a header maker.



STARTUP.EXE - This program will read a config file, determine which sounds
        to play, select one at random, and play it.  The config file can
        contain conditionals to play certain sounds at a certain times.
        Valid conditionals are:

                [Sunday],[Monday],...,[Saturday] - day of the week.
                [00-23] - time of the day.

        Days of the week must be spelled out and have the first letter
        capital and the rest lower case.  Times must be in 24 hour format
        and only hours with 2 digits are accepted (eg: 02, 12, etc.).
        The config file is processed from top to bottom.  You can have a
        section match above, then have another section match below, such
        as have something play at a certain time on a certain day.  An
        example is included, SAMPLE.CFG.



OSC320.EXE - This program is sort of oscillioscope and level meter. The
	data coming in through the Sound Blaster is directly displayed to
	the screen. The video mode used is 320x200x256. A peak level is
	also implemented. This program is neat to watch, and usefull for
	determining the overall sound level.



OSC360.EXE - This program is sort of oscillioscope and level meter. The
	data coming in through the Sound Blaster is directly displayed to
	the screen. The video mode used is 360x480x256. A peak level is
	also implemented. This program is neat to watch, and usefull for
        determining the overall sound level.



Enjoy the programs and remember that at Vroom-Diggy-Diggy, we don't just
make execs, we make weird execs.  (Anybody want a reverse frequency
generator?)

       ** Sound Blaster is a copyright of Creative Labs, Inc. **