3100 SB Audio Card (250-1632) Voice Utilities Faxback Doc. # 2966 These voice utilities are helpful in creating and changing recorded sounds. They can be used in creating special batch files for multimedia applications. These utilities are as follows: -VOC-HDR Adds headers to raw voice files. -JOINTVOC Joins or combines voice file. -VREC Records voice to disk from the command line. -VPLAY Plays digitized voice from disk. -VSR Changes voice file's sampling rate. VOC-HDR This program adds the Creative Voice File header to a raw sound file recorded from other sources. With the header added, Voice Editor and other programs using the CT-VOICE driver can then play the sound file. Entry format: VOC-HDR sourcefile targetfile.voc IMPORTANT: It is necessary to put the .VOC extension on the target file. JOINTVOC With this utility you an combine two or more voice files into a new file. Entry format: JOINTVOC/Ttargetfile.voc file 1.voc file2.voc [/Saa/Mbb/Rcc/RE] NOTE: The parameters [/Saa/Mbb/Rcc/RE] can be added to each voice file to be combined. Decimal values for AA, BB and CC cannot be greater than 32767. EXAMPLE: If you want to join three files, where FILE 2.VOC repeats five times and then pauses for two seconds after playing FILE 2.VOC, this is entered as: JOINTVOC / Ttargetfile.voc /R5 file2.voc /RE /S20 file3.voc ┌────────┬─────────────────────────────────────────────────────────┐ │OPTION │ DESCRIPTION/SPECIFICATIONS │ ├────────┼─────────────────────────────────────────────────────────┤ │Saa │Adds a silence period to a voice file in units of 0.1 │ │ │seconds. │ ├────────┼─────────────────────────────────────────────────────────┤ │Mbb │Adds a marker to the file. During playback of the voice,│ │ │if the marker is encountered, it sends a 2-byte flag. │ │ │An application program can then decide how to act when │ │ │encountering these flags. │ ├────────┼─────────────────────────────────────────────────────────┤ │Rcc │Requests a block to be repeated. If CC equals -1 │ │ │requests non-stop repeating. │ ├────────┼─────────────────────────────────────────────────────────┤ │RE │Ends the repeat command. │ └────────┴─────────────────────────────────────────────────────────┘ VREC With this utility you can record a voice from the DOS command line. The voice is recorded directly to the diskette or hard disk using a double-buffering technique. The length of the recorded voice file is limited only by the disk capacity. Entry format: VREC filename [/B:kk] [/S:hh] [/T:ss] [/Q] [/X="command line"] ┌────────────┬──────────────────────────────────────────────────────────┐ │OPTION │DESCRIPTION/SPECIFICATIONS │ ├────────────┼──────────────────────────────────────────────────────────┤ │filename │Is the filename to store the recorded voice. The default │ │ │extension is .VOC. The voice is stored in the Creative │ │ │Voice File format. │ ├────────────┼──────────────────────────────────────────────────────────┤ │/B:kk │Sets the buffer size used for recording. The program uses│ │ │two buffers during the recording process. KK is the size │ │ │of the buffer in 2K units. If the buffer is not specified│ │ │a default value of 16 is assumed for KK (32K bytes per │ │ │buffer). You can enter a range from 1 to 32 for KK. │ ├────────────┼──────────────────────────────────────────────────────────┤ │/S:hh │Sets the recording sampling rate (frequency). The range │ │ │for HH is from 4000 Hz to 15000 Hz. │ ├────────────┼──────────────────────────────────────────────────────────┤ │/T:ss │Sets the recording time in one second units. The range │ │ │for SS is from 1 to 65535, giving a maximum recording time│ │ │of about 18.20 hours. (Note: This function will not │ │ │work when /X switch is specified). │ ├────────────┼──────────────────────────────────────────────────────────┤ │/Q │Specifies Quite screen mode operation. When specified, │ │ │except for error messages, all other messages are │ │ │suppressed. │ ├────────────┼──────────────────────────────────────────────────────────┤ │/X="command │Go to DOS to execute a DOS command or another program │ │line" │after the voice process is activated. Command line │ │ │specifies the DOS command or a program to be executed │ │ │containing up to 16 parameters. │ └────────────┴──────────────────────────────────────────────────────────┘ VPLAY You use this program to play a voice file from the DOS command line. The voice file can be any size and must be in Creative Voice File Format. Entry format: VPLAY filename[/B:kk] [/T:ss] [/Q] [/X="command line"] ┌─────────────┬─────────────────────────────────────────────────────────┐ │OPTION │ DESCRIPTION/SPECIFICATIONS │ ├─────────────┼─────────────────────────────────────────────────────────┤ │Filename │This is the voice file to play. The default extension is│ │ │.VOC. The voice file must be in the Creative Voice File │ │ │format. │ ├─────────────┼─────────────────────────────────────────────────────────┤ │/B:kk │Sets the buffer size for playback. The program uses two │ │ │buffers during the playback process. KK is the size of │ │ │the buffer in 2K units. If the buffer is not specified, │ │ │a default value of 16 is assumed for KK (32K bytes per │ │ │buffer). You can enter a range from 1 to 32 for KK. │ ├─────────────┼─────────────────────────────────────────────────────────┤ │/T:ss │Sets the playback time in one second units. The range │ │ │for SS is from 1 to 65535. (Note: This function will │ │ │not work when /X switch is specified. │ ├─────────────┼─────────────────────────────────────────────────────────┤ │/Q │Specifies Quiet screen mode operation. When specified, │ │ │except for error messages, all other messages are │ │ │suppressed. │ ├─────────────┼─────────────────────────────────────────────────────────┤ │/X="command │Go to DOS to execute a DOS command or another program │ │line" │after another program after the voice process is │ │ │activated. Command line specifies the DOS command or a │ │ │program to be executed containing up to 16 parameters. │ └─────────────┴─────────────────────────────────────────────────────────┘ VSR This program lets you change or edit the sampling rate of your voice file. You can also play the voice file from this program once you have changed it. Entry Format VSR sourcefile targetfile.voc/Rnn[/O] ┌───────────────┬───────────────────────────────────────────────────────┐ │OPTION │DESCRIPTION/SPECIFICATIONS │ ├───────────────┼───────────────────────────────────────────────────────┤ │sourcefile │The Creative Voice File to process. │ ├───────────────┼───────────────────────────────────────────────────────┤ │tartgetfile.voc│The file that will hold the changed file. │ ├───────────────┼───────────────────────────────────────────────────────┤ │/Rnn │This sets the new sampling rate as a percentage of the │ │ │current sampling rate. For example, if the current │ │ │sampling rate is 10,000 and you want to change it to │ │ │8,000, enter the value of 80. Or, if the current │ │ │sampling rate is 8,000 and you want to change it to │ │ │10,000, you would enter 125 for NN. │ ├───────────────┼───────────────────────────────────────────────────────┤ │/O │Using this option lets you play the voice file after │ │ │changing. This option specifies the value to use to │ │ │determine the silence to be removed. The default value│ │ │for NN is 2. The smaller the value, the tighter the │ │ │silence will be. │ └───────────────┴───────────────────────────────────────────────────────┘ (SMC-05/03/94)