The Batch Voice Import control file (bvi.control)

Each batch voice import utility uses the bvi.control file to determine its operating parameters. This file resides in the $CUR_DIR/ca/BVI_dir directory.

Format of bvi.control

The bvi.control file is an ASCII text file with the following record types:

Comments (# in the first position; the remainder of the line is ignored)
Control statements (any line without # in the first position). Control statements consist of two parts separated by an equals sign (=):
- A control parameter
- The value to which the control parameter is set
Examples of typical control statements are:
```
UMS_INPUT_SELECT=LINE_1
VOICE_FILE_NAME=bvi.voice
```

Table 1 lists the control parameters and tells you which utilities use each of them. The description of each utility (starting with bvi_rec: Batch Voice recording utility) includes more information about how to set these parameters.

If a utility uses a particular control parameter, that parameter must be defined in the control file.

The control parameters can occur in any order, and comments can occur anywhere.

If a control parameter is defined more than once, the value will be taken from the first occurrence; all other occurrences of the same control parameter will be ignored.

Table 1. Batch Voice Import control parameter summary
Parameter Name	Value in Supplied bvi.control	Brief Explanation (for more information, see the individual utilities)	Utilities Using the Parameter
UMS_INPUT_SELECT	LINE_1	Specifies which audio adapter input is to be used for recording.	bvi_rec
BOOST	6	Specifies whether to boost signal frequency components in the range 1500 Hz to 4000 Hz and to cut signal frequency components in the range 0 to 1500 Hz. 0 indicates that voice data is not to be boosted. A positive integer specifies the number of dB by which voice data is to be boosted or cut.	bvi_imp
COMPRESSION_TYPE	1	Specifies the default compression type of voice segments: 0 Compressed only 1 Uncompressed only 2 Compressed and uncompressed	bvi_desc
COPY_TARGET_LANGUAGE	1 (U.S. English)	Specifies the language of the voice directory to be copied to.	bvi_copy
DESCRIPTION	* Segment created by BVI *	Specifies the default description for voice segments.	bvi_desc
DESCR_FILE_NAME	bvi.descr	Specifies the name of the voice description file created by bvi_desc.	bvi_desc bvi_imp bvi_play
END_MARGIN_TIME	20	Specifies the silence time (in milliseconds) which bvi_seg puts after each voice segment. If this parameter is omitted, MARGIN_TIME is used for both before and after margin periods.	bvi_seg
GLITCH_TIME_1	25	Specifies the maximum length (in milliseconds) of silence that can be tolerated within START_TIME before bvi_seg decides that what it has heard so far is not the start of a valid voice segment.	bvi_seg
GLITCH_TIME_2	250	Specifies the maximum length (in milliseconds) of voice activity that can be tolerated within STOP_TIME before bvi_seg decides that what it has heard so far is not the end of a valid voice segment.	bvi_seg
INDEX_FILE_NAME	bvi.index	Specifies the name of the index file.	bvi_desc bvi_imp bvi_play bvi_seg
LANGUAGE	1 (U.S. English)	Specifies the default language of the voice segment database in which the voice segments are stored.	bvi_copy bvi_delete bvi_list bvi_seg
LIST_DESCR_FILE_NAME	bvi.descr	Specifies the name of the description file to be created by bvi_list.	bvi_list
MARGIN_TIME	20	Specifies the time (in milliseconds) that bvi_seg puts before and after the detected start and end of a segment.	bvi_seg
MAXIMIZE	1	Specifies whether the voice data is to be amplified such that each segment uses the full range available.	bvi_imp
PROTECT	1	Specifies whether existing voice segments are to be protected from accidental overwrite.	bvi_copy bvi_imp
SEGMENT_START_ID	1	Specifies the default id for the first segment to be processed.	bvi_desc
START_TIME	50	Specifies the minimum length (in milliseconds) of voice activity for bvi_seg to decide that a segment has started.	bvi_seg
STOP_TIME	1500	Specifies the minimum length (in milliseconds) of silence for bvi_seg to decide that a segment has ended.	bvi_seg
THRESHOLD_LEVEL	-40	Specifies the level in dBm that bvi_seg uses to decide whether an incoming signal is silence or voice.	bvi_seg
TRACE	0	Specifies whether tracing is on or off. (Dumps trace information to screen.)	bvi_seg
VOICE_DIRECTORY_NAME	BVI	Specifies the name of the default voice directory in which all segments are to be stored. For more information, see Custom Servers ID and name limitations.	bvi_desc
VOICE_FILE_NAME	bvi.voice	Specifies the name of the voice file created by bvi_rec and used by the other utilities.	bvi_aiff bvi_desc bvi_imp bvi_play bvi_rec bvi_seg bvi_wav