mlib_SignalLPCPerceptWeight_F32(3MLIB)

Name

mlib_SignalLPCPerceptWeight_F32 - perform perceptual weighting on input signal

Synopsis

cc [ flag... ] file... –lmlib [ library... ]
#include <mlib.h>

mlib_status mlib_SignalLPCPerceptWeight_F32(mlib_f32 *sigwgt,
     const mlib_f32 *signal, const mlib_f32 *lpc, mlib_f32 r1,
     mlib_f32 r2, void *state);

Description

The mlib_SignalLPCPerceptWeight_F32() function performs perceptual weighting on input signal.

The perceptual weighting filter is defined as following.

	        A(z*r1)
	W(z) = ---------
	        A(z*r2)

where A(z) is the inverse filter

	            M          -i
	A(z) = 1 - SUM a(i) * z
	           i=1

See G.723.1, G.728, G.729, G.729A, GSM EFR standards.

Parameters

The function takes the following arguments:

sigwgt

The weighted signal vector.

signal

The input signal vector.

lpc

The linear prediction coefficients.

r1

The perceptual weighting filter coefficient, it is treated as 1 if 0 is supplied.

r2

The perceptual weighting filter coefficient, it is treated as 1 if 0 is supplied.

state

Pointer to the internal state structure.

Return Values

The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level MT-Safe

See also

mlib_SignalLPCPerceptWeightInit_F32(3MLIB), mlib_SignalLPCPerceptWeightFree_F32(3MLIB), attributes(5)