mediaLib Library Functions               mlibImageConv5x5(3MLIB)



NAME
     mlibImageConv5x5 - 5x5 convolution

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

     mlibstatus mlibImageConv5x5(mlibimage *dst, const mlibimage *src,
          const mlibs32 *kernel, mlibs32 scale, mlibs32 cmask,
          mlibedge edge);


DESCRIPTION
     The mlibImageConv5x5() function performs a 5x5  convolution
     on the source image by using the user-supplied kernel.


     The input image and the output  image  must  have  the  same
     image  type  and  have  the  same  number  of  channels. The
     unselected channels in the output image are not overwritten.
     For single-channel images, the channel mask is ignored.


     For this convolution, the key  element  of  the  convolution
     kernel is located at the center of the kernel matrix.


     It uses the following equation:

                      m-1-dm n-1-dn
       dst[x][y][i] =  SUM    SUM  src[x]p][y]q][i]*k[p][q]*2**(-scale)
                      p=-dm  q=-dn



     where m = 5, n = 5, dm = (m - 1)/2 = 2, dn = (n - 1)/2 = 2.

PARAMETERS
     The function takes the following arguments:

     dst       Pointer to destination image.


     src       Pointer to source image.


     kernel    Pointer to the convolution kernel,  in  row  major
               order.


     scale     Scaling factor.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions               mlibImageConv5x5(3MLIB)



     cmask     Channel mask to indicate the channels to  be  con-
               volved,  each bit of which represents a channel in
               the image. The channels corresponding to bits with
               a  value  of  1  are  those to be processed. For a
               single-channel image, the channel mask is ignored.


     edge      Type of edge condition. It can be one of the  fol-
               lowing:

                 MLIBEDGEDSTNOWRITE
                 MLIBEDGEDSTFILZERO
                 MLIBEDGEDSTCOPYSRC
                 MLIBEDGESRCEXTEND



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
     mlibImageConv2x2(3MLIB),       mlibImageConv2x2Fp(3MLIB),
     mlibImageConv2x2Index(3MLIB),     mlibImageConv3x3(3MLIB),
     mlibImageConv3x3Fp(3MLIB),  mlibImageConv3x3Index(3MLIB),
     mlibImageConv4x4(3MLIB),       mlibImageConv4x4Fp(3MLIB),
     mlibImageConv4x4Index(3MLIB),  mlibImageConv5x5Fp(3MLIB),
     mlibImageConv5x5Index(3MLIB),     mlibImageConv7x7(3MLIB),
     mlibImageConv7x7Fp(3MLIB),  mlibImageConv7x7Index(3MLIB),
     mlibImageConvKernelConvert(3MLIB),
     mlibImageConvMxN(3MLIB),       mlibImageConvMxNFp(3MLIB),
     mlibImageConvMxNIndex(3MLIB), mlibImageConvolveMxN(3MLIB),
     mlibImageConvolveMxNFp(3MLIB),  mlibImageSConv3x3(3MLIB),
     mlibImageSConv3x3Fp(3MLIB),     mlibImageSConv5x5(3MLIB),
     mlibImageSConv5x5Fp(3MLIB),     mlibImageSConv7x7(3MLIB),
     mlibImageSConv7x7Fp(3MLIB),
     mlibImageSConvKernelConvert(3MLIB), attributes(5)



SunOS 5.11           Last change: 2 Mar 2007                    2