Prosody speech processing: API: sm_adjust_catsig_module_params

Prototype Definition

int sm_adjust_catsig_module_params(struct sm_adjust_catsig_module_parms *catsigp)

Parameters

*catsigp
a structure of the following type:
typedef struct sm_adjust_catsig_module_parms {
	tSMModuleId module;					/* in */
	tSM_INT catsig_alg_id;					/* in */
	enum kSMBESPCatSigParam {
		kSMBESPCatSigParamF_ln_nrg_coeff=2,
		kSMBESPCatSigParamF_min_Lmin,
		kSMBESPCatSigParamF_Lmin_decay,
		kSMBESPCatSigParamF_speech_thresh,
		kSMBESPCatSigParamF_debounce,
		kSMBESPCatSigParamI_min_valid_period_count,
		kSMBESPCatSigParamI_min_valid_count,
		kSMBESPCatSigParamI_glitch_count,
		kSMBESPCatSigParamI_qualify_count,
		kSMBESPCatSigParamI_alter_duration,
		kSMBESPCatSigParamI_max_valid_tone_cnt,
		kSMBESPCatSigParamI_min_valid_speech_cnt,
		kSMBESPCatSigParamI_threshold_samp_cnt,
		kSMBESPCatSigParamI_delay_time,
		kSMBESPCatSigParamI_period_time,
		kSMBESPCatSigParamI_min_off_count,
		kSMBESPCatSigParamI_min_period_off,
		kSMBESPCatSigParamF_initial_Lmax,
	} parameter_id;						/* in */
	union {
		double fp_value;				/* in */
		tSM_INT int_value;				/* in */
	} parameter_value;					/* in */
} SM_ADJUST_CATSIG_MODULE_PARMS;

Description

Adjust parameter for signal categorisation algorithm.

Invoking the call will change a single signal categorisation parameter for the given signal categorisation algorithm, that parameter being identified by the value supplied parameter_id.

The new parameter value must be set in either the fp_value or int_value element of the parameter_value union according to the parameter type.

Adjusting parameters for the signal categorisation algorithm requires extreme care and should be attempted only under the guidance of Aculab support. For more background information on how the algorithm works, please refer to Prosody application note: Live Speaker Detection

Fields

module
The module whose signal categorisation parameters are to be modified.
catsig_alg_id
The algorithm identifier of the algorithm whose parameters are to be modified.
parameter_id
The parameter to be modified. One of these values:
kSMBESPCatSigParamF_ln_nrg_coeff
kSMBESPCatSigParamF_min_Lmin
kSMBESPCatSigParamF_Lmin_decay
kSMBESPCatSigParamF_speech_thresh
kSMBESPCatSigParamF_debounce
kSMBESPCatSigParamI_min_valid_period_count
kSMBESPCatSigParamI_min_valid_count
kSMBESPCatSigParamI_glitch_count
kSMBESPCatSigParamI_qualify_count
kSMBESPCatSigParamI_alter_duration
kSMBESPCatSigParamI_max_valid_tone_cnt
kSMBESPCatSigParamI_min_valid_speech_cnt
kSMBESPCatSigParamI_threshold_samp_cnt
kSMBESPCatSigParamI_delay_time
kSMBESPCatSigParamI_period_time
kSMBESPCatSigParamI_min_off_count
kSMBESPCatSigParamI_min_period_off
kSMBESPCatSigParamF_initial_Lmax
parameter_value
The parameter value.
fp_value
A floating-point value. Used when the parameter_id refers to a floating point parameter (i.e. its name contains ParamF).
int_value
An integer value. Used when the parameter_id refers to an integer parameter (i.e. its name contains ParamI).

Returns

0 if call completed successfully, otherwise a standard error such as:


This function is part of the Prosody speech processing API.