1mlib_ImageSConv3x3_Fp(3MLIBm)ediaLib Library Functionmslib_ImageSConv3x3_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageSConv3x3_Fp - separable 3x3 convolution
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageSConv3x3_Fp(mlib_image *dst, const mlib_image *src,
13            const mlib_d64 *hkernel, const mlib_d64 *vkernel, mlib_s32 cmask,
14            mlib_edge edge);
15
16

DESCRIPTION

18       The  mlib_ImageSConv3x3_Fp() function performs a separable 3x3 convolu‐
19       tion on the source image by using the user-supplied kernel.
20
21
22       It uses the following equation:
23
24                        m-1-dm n-1-dn
25         dst[x][y][i] =  SUM    SUM  src[x+p][y+q][i]*h[p]*v[q]
26                        p=-dm  q=-dn
27
28
29
30       where m = 3, n = 3, dm = (m - 1)/2 = 1, dn = (n - 1)/2 = 1.
31

PARAMETERS

33       The function takes the following arguments:
34
35       dst        Pointer to destination image.
36
37
38       src        Pointer to source image.
39
40
41       hkernel    Pointer to the horizontal kernel.
42
43
44       vkernel    Pointer to the vertical kernel.
45
46
47       cmask      Channel mask to indicate the channels to be convolved,  each
48                  bit of which represents a channel in the image. The channels
49                  corresponding to one bits are those to be processed.  For  a
50                  single-channel image, the channel mask is ignored.
51
52
53       edge       Type of edge condition. It can be one of the following:
54
55                    MLIB_EDGE_DST_NO_WRITE
56                    MLIB_EDGE_DST_FILL_ZERO
57                    MLIB_EDGE_DST_COPY_SRC
58                    MLIB_EDGE_SRC_EXTEND
59
60
61

RETURN VALUES

63       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
64       MLIB_FAILURE.
65

ATTRIBUTES

67       See attributes(5) for descriptions of the following attributes:
68
69
70
71
72       ┌─────────────────────────────┬─────────────────────────────┐
73       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │Interface Stability          │Committed                    │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │MT-Level                     │MT-Safe                      │
78       └─────────────────────────────┴─────────────────────────────┘
79

SEE ALSO

81       mlib_ImageConv2x2(3MLIB),   mlib_ImageConv2x2_Fp(3MLIB),    mlib_Image‐
82       Conv2x2Index(3MLIB),        mlib_ImageConv3x3(3MLIB),       mlib_Image‐
83       Conv3x3_Fp(3MLIB),      mlib_ImageConv3x3Index(3MLIB),      mlib_Image‐
84       Conv4x4(3MLIB),         mlib_ImageConv4x4_Fp(3MLIB),        mlib_Image‐
85       Conv4x4Index(3MLIB),       mlib_ImageConv5x5(3MLIB),        mlib_Image‐
86       Conv5x5_Fp(3MLIB),      mlib_ImageConv5x5Index(3MLIB),      mlib_Image‐
87       Conv7x7(3MLIB),        mlib_ImageConv7x7_Fp(3MLIB),         mlib_Image‐
88       Conv7x7Index(3MLIB), mlib_ImageConvKernelConvert(3MLIB), mlib_ImageCon‐
89       vMxN(3MLIB),     mlib_ImageConvMxN_Fp(3MLIB),      mlib_ImageConvMxNIn‐
90       dex(3MLIB),         mlib_ImageConvolveMxN(3MLIB),        mlib_ImageCon‐
91       volveMxN_Fp(3MLIB),                          mlib_ImageSConv3x3(3MLIB),
92       mlib_ImageSConv5x5(3MLIB),                mlib_ImageSConv5x5_Fp(3MLIB),
93       mlib_ImageSConv7x7(3MLIB),                mlib_ImageSConv7x7_Fp(3MLIB),
94       mlib_ImageSConvKernelConvert(3MLIB), attributes(5)
95
96
97
98SunOS 5.11                        2 Mar 2007      mlib_ImageSConv3x3_Fp(3MLIB)
Impressum