mediaLib Library Functions       mlibSignalAutoCorrelS16(3MLIB)



NAME
     mlibSignalAutoCorrelS16,       mlibSignalAutoCorrelS16S,
     mlibSignalAutoCorrelF32, mlibSignalAutoCorrelF32S - sig-
     nal auto-correlation

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

     mlibstatus mlibSignalAutoCorrelS16(mlibd64 *correl,
          const mlibs16 *src, mlibs32 disp, mlibs32 n);


     mlibstatus mlibSignalAutoCorrelS16S(mlibd64 *correl,
          const mlibs16 *src, mlibs32 disp, mlibs32 n);


     mlibstatus mlibSignalAutoCorrelF32(mlibd64 *correl,
          const mlibf32 *src, mlibs32 disp, mlibs32 n);


     mlibstatus mlibSignalAutoCorrelF32S(mlibd64 *correl,
          const mlibf32 *src, mlibs32 disp, mlibs32 n);


DESCRIPTION
     Each of these functions performs auto-correlation.


     For monaural signals, the following equation is used:

                     1    n-d-1
       correl[0] = ----- * SUM (src[i] * src[i ] d])
                   n - d   i=0



     For stereo signals, the following equation is used:

                     1    n-d-1
       correl[0] = ----- * SUM (src[2*i] * src[2*(i ] d)])
                   n - d   i=0

                     1    n-d-1
       correl[1] = ----- * SUM (src[2*i ] 1] * src[2*(i ] d) ] 1])
                   n - d   i=0



     where d = disp.





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions       mlibSignalAutoCorrelS16(3MLIB)



PARAMETERS
     Each of the functions takes the following arguments:

     correl    Pointer to  the  auto-correlation  array.  In  the
               stereo   version,  correl[0]  contains  the  auto-
               correlation of channel 0, and  correl[1]  contains
               the auto-correlation of channel 1.


     src       Source signal array.


     disp      Displacement. 0 < disp < n.


     n         Number of samples in the source signal array.


RETURN VALUES
     Each of the functions 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
     mlibSignalCrossCorrelS16(3MLIB), attributes(5)
















SunOS 5.11           Last change: 2 Mar 2007                    2