sunos man page for mlib_signallpcperceptweight_f32

mlib_SignalLPCPerceptWeight_F32(3MLIB)			    mediaLib Library Functions			    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	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.10							    10 Nov 2004 			    mlib_SignalLPCPerceptWeight_F32(3MLIB)