cvelem (Convert to elements program)

This utility custom server converts audio data from a 16-bit big-Endian 8 kHz data file, to a file containing element structures, identical to the element structures returned from the CA_Get_Segment custom server API call.

This utility accepts command line parameters.

cvelem issues a CA_Import_Voice call to get elements and writes them to a file. Next it uses the CA_Get_Element_Info call to get the dBm level of the elements. The dBm level is displayed on stdout. If you are using dynamic voice data and want to know the peak dBm level, you can see it in stdout.

You can use the pl_elem music player to play the converted file.

cvelem is located in the $DB/current_dir/ca/cvelem_dir.

Syntax

cvelem -s source_file -t target_file

[-sample_rate number]

[-sample_width number]

[-format_alaw | -format_ulaw | -format_smag | -format_twoc | -format_mag]

[-big_endian | -little_endian]

[-talaw | -tulaw]

Parameters

-s source_file
A mandatory parameter. The name of the file containing the voice data. The source file is usually obtained using the batch voice import utility (for more information, see the Using the Blueworx Voice Response windows for voice segments).
-t target_file
A mandatory parameter. The filename of the elements file created by cvelem.
-sample_rate number
An optional parameter. The rate in hertz at which the voice was sampled. The minimum value is 8000.
-sample_width number
An optional parameter. The number of bits representing each sample in the source file. Valid values are 8 or 16, depending on the format.

This parameter defaults to 16.

-format_*
None or one of these flags is allowed. It defines the format of the samples in the source file. The default is -format_twoc.
-big_endian | -little_endian
An optional parameter. This parameter describes the format of the source file; it applies to 16 bit samples only. Use one of these options; the default is -big_endian.
-talaw | -tulaw
An optional parameter. Use one of these options; the default is -tulaw. This parameter defines the format of the target data.