mediaLib Library Functions              mlibImageSConv5x5(3MLIB)



NAME
     mlibImageSConv5x5 - separable 5x5 convolution

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

     mlibstatus mlibImageSConv5x5(mlibimage *dst, const mlibimage *src,
          const mlibs32 *hkernel, const mlibs32 *vkernel, mlibs32 scale,
          mlibs32 cmask, mlibedge edge);


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


     It uses the following equation:

                      m-1-dm n-1-dn
       dst[x][y][i] =  SUM    SUM  src[x]p][y]q][i]*h[p]*v[q]*2**(-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.


     hkernel    Pointer to the horizontal kernel.


     vkernel    Pointer to the vertical kernel.


     scale      Scaling factor.


     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 one bits
                are  those  to be processed. For a single-channel
                image, the channel mask is ignored.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions              mlibImageSConv5x5(3MLIB)



     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),     mlibImageConv5x5(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),  mlibImageSConv5x5Fp(3MLIB),
     mlibImageSConv7x7(3MLIB),     mlibImageSConv7x7Fp(3MLIB),
     mlibImageSConvKernelConvert(3MLIB), attributes(5)










SunOS 5.11           Last change: 2 Mar 2007                    2