mediaLib Library Functions          mlibImageConv5x5Index(3MLIB)



NAME
     mlibImageConv5x5Index - 5x5 convolution on a color  indexed
     image

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

     mlibstatus mlibImageConv5x5Index(mlibimage *dst, const mlibimage *src,
          const mlibs32 *kernel, mlibs32 scale, mlibedge edge,
          const void *colormap);


DESCRIPTION
     The mlibImageConv5x5Index() function performs a 5x5  convo-
     lution  the  color  indexed  source image by using the user-
     supplied kernel. The source and destination images  must  be
     single-channel images.


     The input and output images must have the  same  image  type
     and size.


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


     This function performs  the  convolution  on  color  indexed
     image.  The  input image and the output image must be single
     channel  images.  The  image  type  must  be  MLIBYTE   or
     MLIBSHORT.


     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.




SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions          mlibImageConv5x5Index(3MLIB)



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


     scale       Scaling factor.


     edge        Type of edge condition. It can  be  one  of  the
                 following:

                   MLIBEDGEDSTNOWRITE
                   MLIBEDGEDSTFILZERO
                   MLIBEDGEDSTCOPYSRC
                   MLIBEDGESRCEXTEND



     colormap    Internal data structure for inverse  color  map-
                 ping.  This  data  structure is generated by the
                 mlibImageColorTrue2IndexInit() function.


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),       mlibImageConv7x7(3MLIB),
     mlibImageConv7x7Fp(3MLIB),  mlibImageConv7x7Index(3MLIB),
     mlibImageConvKernelConvert(3MLIB),
     mlibImageConvMxN(3MLIB),       mlibImageConvMxNFp(3MLIB),
     mlibImageConvMxNIndex(3MLIB), mlibImageConvolveMxN(3MLIB),



SunOS 5.11           Last change: 2 Mar 2007                    2






mediaLib Library Functions          mlibImageConv5x5Index(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                    3