mediaLib Library Functions      mlibSignalCrossCorrelS16(3MLIB)



NAME
     mlibSignalCrossCorrelS16,     mlibSignalCrossCorrelS16S,
     mlibSignalCrossCorrelF32,   mlibSignalCrossCorrelF32S  -
     signal cross correlation

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

     mlibstatus mlibSignalCrossCorrelS16(mlibd64 *correl,
          const mlibs16 *src1, const mlibs16 *src2, mlibs32 n);


     mlibstatus mlibSignalCrossCorrelS16S(mlibd64 *correl,
          const mlibs16 *src1, const mlibs16 *src2, mlibs32 n);


     mlibstatus mlibSignalCrossCorrelF32(mlibd64 *correl,
          const mlibf32 *src1, const mlibf32 *src2, mlibs32 n);


     mlibstatus mlibSignalCrossCorrelF32S(mlibd64 *correl,
          const mlibf32 *src1, const mlibf32 *src2, mlibs32 n);


DESCRIPTION
     Each of these functions performs cross correlation.


     For monaural signals, the following equation is used:

                    1    n-1
       correl[0] = --- * SUM (src1[i] * src2[i])
                    n    i=0



     For stereo signals, the following equation is used:

                    1    n-1
       correl[0] = --- * SUM (src1[2*i] * src2[2*i])
                    n    i=0

                    1    n-1
       correl[1] = --- * SUM (src1[2*i ] 1] * src2[2*i ] 1])
                    n    i=0


PARAMETERS
     Each of the functions takes the following arguments:





SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions      mlibSignalCrossCorrelS16(3MLIB)



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


     src1      First source signal array.


     src2      Second source signal array.


     n         Number of samples in the source signal arrays.


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
     mlibSignalAutoCorrelS16(3MLIB), attributes(5)



















SunOS 5.11           Last change: 2 Mar 2007                    2