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 IBM-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