1mlib_ImageConvMxNIndex(3MLImBe)diaLib Library Functiomnlsib_ImageConvMxNIndex(3MLIB)
2
3
4

NAME

6       mlib_ImageConvMxNIndex - MxN convolution on a color indexed image
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageConvMxNIndex(mlib_image *dst, const mlib_image *src,
13            const mlib_s32 *kernel, mlib_s32 m, mlib_s32 n, mlib_s32 dm,
14            mlib_s32 dn, mlib_s32 scale, mlib_edge edge, const void *colormap);
15
16

DESCRIPTION

18       The mlib_ImageConvMxNIndex() function performs a MxN convolution on the
19       color indexed source image by using the user-supplied kernel.
20
21
22       The input and output images must have the same image type and size.
23
24
25       For this convolution, the key element  of  the  convolution  kernel  is
26       located at (dm, dn) of the kernel matrix.
27
28
29       This  function  performs  the convolution on a color indexed image. The
30       input image and the output image must  be  single-channel  images.  The
31       image type must be MLIB_BYTE or MLIB_SHORT.
32
33
34       It uses the following equation:
35
36                        m-1-dm n-1-dn
37         dst[x][y][i] =  SUM    SUM  src[x+p][y+q][i]*k[p][q]*2**(-scale)
38                        p=-dm  q=-dn
39
40
41
42       where m > 1, n > 1, 0 ≤ dm < m, 0 ≤ dn < n.
43

PARAMETERS

45       The function takes the following arguments:
46
47       dst         Pointer to destination image.
48
49
50       src         Pointer to source image.
51
52
53       kernel      Pointer to the convolution kernel, in row major order.
54
55
56       m           Width of the convolution kernel. m > 1.
57
58
59       n           Height of the convolution kernel. n > 1.
60
61
62       dm          X  coordinate of the key element in the convolution kernel.
63                   0 ≤ dm < m.
64
65
66       dn          Y coordinate of the key element in the convolution  kernel.
67                   0 ≤ dn < n.
68
69
70       scale       Scaling factor.
71
72
73       edge        Type of edge condition. It can be one of the following:
74
75                     MLIB_EDGE_DST_NO_WRITE
76                     MLIB_EDGE_DST_FILL_ZERO
77                     MLIB_EDGE_DST_COPY_SRC
78                     MLIB_EDGE_SRC_EXTEND
79
80
81
82       colormap    Internal  data  structure  for  inverse color mapping. This
83                   data  structure  is   generated   by   the   mlib_ImageCol‐
84                   orTrue2IndexInit() function.
85
86

RETURN VALUES

88       The  function  returns MLIB_SUCCESS if successful. Otherwise it returns
89       MLIB_FAILURE.
90

ATTRIBUTES

92       See attributes(5) for descriptions of the following attributes:
93
94
95
96
97       ┌─────────────────────────────┬─────────────────────────────┐
98       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
99       ├─────────────────────────────┼─────────────────────────────┤
100       │Interface Stability          │Committed                    │
101       ├─────────────────────────────┼─────────────────────────────┤
102       │MT-Level                     │MT-Safe                      │
103       └─────────────────────────────┴─────────────────────────────┘
104

SEE ALSO

106       mlib_ImageConv2x2(3MLIB),   mlib_ImageConv2x2_Fp(3MLIB),    mlib_Image‐
107       Conv2x2Index(3MLIB),        mlib_ImageConv3x3(3MLIB),       mlib_Image‐
108       Conv3x3_Fp(3MLIB),      mlib_ImageConv3x3Index(3MLIB),      mlib_Image‐
109       Conv4x4(3MLIB),         mlib_ImageConv4x4_Fp(3MLIB),        mlib_Image‐
110       Conv4x4Index(3MLIB),       mlib_ImageConv5x5(3MLIB),        mlib_Image‐
111       Conv5x5_Fp(3MLIB),      mlib_ImageConv5x5Index(3MLIB),      mlib_Image‐
112       Conv7x7(3MLIB),        mlib_ImageConv7x7_Fp(3MLIB),         mlib_Image‐
113       Conv7x7Index(3MLIB), mlib_ImageConvKernelConvert(3MLIB), mlib_ImageCon‐
114       vMxN(3MLIB), mlib_ImageConvMxN_Fp(3MLIB), mlib_ImageConvolveMxN(3MLIB),
115       mlib_ImageConvolveMxN_Fp(3MLIB),             mlib_ImageSConv3x3(3MLIB),
116       mlib_ImageSConv3x3_Fp(3MLIB),                mlib_ImageSConv5x5(3MLIB),
117       mlib_ImageSConv5x5_Fp(3MLIB),                mlib_ImageSConv7x7(3MLIB),
118       mlib_ImageSConv7x7_Fp(3MLIB),      mlib_ImageSConvKernelConvert(3MLIB),
119       attributes(5)
120
121
122
123SunOS 5.11                        2 Mar 2007     mlib_ImageConvMxNIndex(3MLIB)
Impressum