mediaLib Library Functions
                           mlibSignalLPCPerceptWeightS16(3MLIB)



NAME
     mlibSignalLPCPerceptWeightS16 - perform perceptual weight-
     ing on input signal

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibSignalLPCPerceptWeightS16(mlibs16 *sigwgt,
          const mlibs16 *signal,  const mlibs16 *lpc, mlibs32 lscale,
          mlibs16 r1, mlibs16 r2, void *state);


DESCRIPTION
     The mlibSignalLPCPerceptWeightS16() function performs per-
     ceptual 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, the signal samples are
               in Q15 format.


     signal    The input signal vector, the signal samples are in
               Q15 format.


     lpc       The linear prediction coefficients.






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions
                           mlibSignalLPCPerceptWeightS16(3MLIB)



     lscale    The scaling factor of the linear prediction  coef-
               ficients,  where  actualdata = inputdata * 2**(-
               scalingfactor).


     r1        The perceptual weighting filter  coefficient,  the
               coefficient  is  in Q15 format, it is treated as 1
               if 0 is supplied.


     r2        The perceptual weighting filter  coefficient,  the
               coefficient  is  in Q15 format, it is treated as 1
               if 0 is supplied.


     state     Pointer to the internal state structure.


RETURN VALUES
     The function returns MLIBSUCES if  successful.  Otherwise
     it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



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


SEE ALSO
     mlibSignalLPCPerceptWeightInitS16(3MLIB),
     mlibSignalLPCPerceptWeightFreeS16(3MLIB), attributes(5)














SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions
                           mlibSignalLPCPerceptWeightS16(3MLIB)






















































SunOS 5.11           Last change: 2 Mar 2007                    3