Prosody signal path processing: API: sm_path_mix

Prototype Definition

int sm_path_mix(struct sm_path_mix_parms *mixp)

Parameters

*mixp

a structure of the following type:

typedef struct sm_path_mix_parms {
	tSMPathId path;						/* in */
	tSM_INT enable;						/* in */
	tSMDatafeedId mixin;					/* in */
	tSM_INT volume;						/* in */
} SM_PATH_MIX_PARMS;

Description

Configures signal mixing on a signal path. The specified signal is added into the signal being processed by this path, and the result is adjusted according to the volume parameter, which has a range of at least -24 to +8 dB. Typically, the signal is adjusted by -6 dB to prevent the sum of the two signals being louder than each original signal.

Requires the module gainbg.

Fields

path

The signal path to be configured

enable

Enables (non-zero) or disables (zero) adding another signal to the input signal.

mixin

The datafeed which is the signal to be added. Only used if enable is non-zero.

volume

Volume adjustment (dB).

Returns

0 if call completed successfully, otherwise a standard error.

This function is part of the Prosody signal path processing API.