Manual Pages for UNIX Operating System command usage for man mlib_ImageSConv5x5_Fp

mediaLib Library Functions           mlib_ImageSConv5x5_Fp(3MLIB)



NAME
     mlib_ImageSConv5x5_Fp - separable 5x5 convolution

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

     mlib_status mlib_ImageSConv5x5_Fp(mlib_image *dst, const mlib_image *src,
          const mlib_d64 *hkernel, const mlib_d64 *vkernel, mlib_s32 cmask,
          mlib_edge edge);


DESCRIPTION
     The mlib_ImageSConv5x5_Fp() 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]
                      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.


     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.


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



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions           mlib_ImageSConv5x5_Fp(3MLIB)



                  MLIB_EDGE_DST_NO_WRITE
                  MLIB_EDGE_DST_FILL_ZERO
                  MLIB_EDGE_DST_COPY_SRC
                  MLIB_EDGE_SRC_EXTEND



RETURN VALUES
     The function returns MLIB_SUCCESS if  successful.  Otherwise
     it returns MLIB_FAILURE.

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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     mlib_ImageConv2x2(3MLIB),       mlib_ImageConv2x2_Fp(3MLIB),
     mlib_ImageConv2x2Index(3MLIB),     mlib_ImageConv3x3(3MLIB),
     mlib_ImageConv3x3_Fp(3MLIB),  mlib_ImageConv3x3Index(3MLIB),
     mlib_ImageConv4x4(3MLIB),       mlib_ImageConv4x4_Fp(3MLIB),
     mlib_ImageConv4x4Index(3MLIB),     mlib_ImageConv5x5(3MLIB),
     mlib_ImageConv5x5_Fp(3MLIB),  mlib_ImageConv5x5Index(3MLIB),
     mlib_ImageConv7x7(3MLIB),       mlib_ImageConv7x7_Fp(3MLIB),
     mlib_ImageConv7x7Index(3MLIB),
     mlib_ImageConvKernelConvert(3MLIB),
     mlib_ImageConvMxN(3MLIB),       mlib_ImageConvMxN_Fp(3MLIB),
     mlib_ImageConvMxNIndex(3MLIB), mlib_ImageConvolveMxN(3MLIB),
     mlib_ImageConvolveMxN_Fp(3MLIB),  mlib_ImageSConv3x3(3MLIB),
     mlib_ImageSConv3x3_Fp(3MLIB),     mlib_ImageSConv5x5(3MLIB),
     mlib_ImageSConv7x7(3MLIB),     mlib_ImageSConv7x7_Fp(3MLIB),
     mlib_ImageSConvKernelConvert(3MLIB), attributes(5)













SunOS 5.11           Last change: 2 Mar 2007                    2