1mlib_ImageConvMxNIndex(3MLImBe)diaLib Library Functiomnlsib_ImageConvMxNIndex(3MLIB)
2
3
4
6 mlib_ImageConvMxNIndex - MxN convolution on a color indexed image
7
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
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
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
88 The function returns MLIB_SUCCESS if successful. Otherwise it returns
89 MLIB_FAILURE.
90
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
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)