mediaLib Library Functions           mlibImageCrossCorrel(3MLIB)



NAME
     mlibImageCrossCorrel - cross correlation

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

     mlibstatus mlibImageCrossCorrel(mlibd64 *correl, const mlibimage *img1,
          const mlibimage *img2);


DESCRIPTION
     The mlibImageCrossCorrel()  function  computes  the  cross-
     correlation between a pair of images.


     It uses the following equation:

                     1     w-1 h-1
       correl[i] = ----- * SUM SUM (img1[x][y][i] * img2[x][y][i])
                    w*h    x=0 y=0



     where w and h are  the  width  and  height  of  the  images,
     respectively.

PARAMETERS
     The function takes the following arguments:

     correl    Pointer to cross correlation array  on  a  channel
               basis.  The  array must be the size of channels in
               the  images.   correl[i]   contains   the   cross-
               correlation of channel i.


     img1      Pointer to first image.


     img2      Pointer to second image.


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

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






SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions           mlibImageCrossCorrel(3MLIB)



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


SEE ALSO
     mlibImageAutoCorrel(3MLIB), mlibImageAutoCorrelFp(3MLIB),
     mlibImageCrossCorrelFp(3MLIB),
     mlibImageNormCrossCorrel(3MLIB),
     mlibImageNormCrossCorrelFp(3MLIB), attributes(5)









































SunOS 5.11           Last change: 2 Mar 2007                    2