VOC2WAV.EXE and WAV2VOC.EXE
===========================

	VOC2WAV.EXE - converts Creative .VOC files to Microsoft .WAV files
	WAV2VOC.EXE - converts Microsoft .WAV files to Creative .VOC files

    With these programs, existing Sound Blaster Voice files may now be
    easily ported to the Microsoft Multimedia platform, and vice versa.


USAGE

    The command-line formats of these programs are as follows:

	1)      VOC2WAV sourcefile [targetfile] /switches

	    where
		sourcefile    ----  Source VOC file to convert from.
		targetfile    ----  Destination WAV file to convert to.

		and switches are:

		/C[1|2]       ----  Channel: 1=mono, 2=stereo.
		/R[11|22|44]  ----  Sampling Rate in kHz, default = 11k.
		/S[ON|OFF]    ----  Expand Silence, default = off.
		/L[ON|OFF]    ----  Expand Repeat loop, default = off.

	    The /S option allows silence blocks in the VOC file to be
	    expanded into a block of WAV silence data.

            The /L option allows VOC file repeat blocks to be expanded,
            i.e. the WAV data will be replicated for the count specified
            in the VOC file repeat. Note that negative repeat counts are
            ignored  and  there  will be just one WAV  data  block  for
            repeating.

	Examples:

	    VOC2WAV sample.voc
		Performs a default conversion: mono voice data, sampling
                rate 11 kHz, don't expand silence blocks, don't expand
                repeat blocks.

	    VOC2WAV sample.voc newsamp.wav /C2
		Performs a stereo voice data conversion.

	    VOC2WAV sample.voc repsamp.wav /C2 /LON
		Performs a conversion with repeat blocks expanded. If
		sample.voc has the following format:

		    Ŀ
		      Repeat 2       
		          VOCdata    
		      EndRepeat      
		    

		The output file (repsamp.wav) will have the following data:

		    Ŀ
		      WAVdata        
		      WAVdata        
		      WAVdata        
		    


      2)        WAV2VOC sourcefile [targetfile]

	    where
		sourcefile    ----  Source WAV file to convert from.
		targetfile    ----  Destination VOC file to convert to.

	    Note:   DOS wildcards (*,?) may be specified for sourcefile,
		    in which case the targetfile will have the same names
		    as the sourcefiles but with extension of .VOC.

	Examples:

	    WAV2VOC wavsamp.wav
		Converts the file wavsamp.wav to wavsamp.voc

	    WAV2VOC *.wav
		Converts all WAV files to VOC files with the same name.


CONSTRAINTS

    There are a number of points to note about VOC to WAV conversion due
    to the richness of the VOC file format.

    -   As WAV files only support 11KHz, 22KHz and 44KHz, all VOC files 
	would  be  converted based on these rates.  User  can, however, 
	stipulate whether they would prefer to step up or down from the 
	original sampling rates.
    -   Although the program takes care of different sampling rates, we
	recommend that the original sampling rates should match one of the 
	above sampling rates.
    -   Since the Microsoft WAV file format supports only one block of data,
	it can be played at only one sampling rate. Thus source VOC files 
	for conversion should only contain blocks of the same sampling rate.
    -   Repeat loops in the VOC file should not be nested.
    -   Packed data blocks in the VOC file are ignored.
