1mlib_ImageConv5x5Index(3MLImBe)diaLib Library Functiomnlsib_ImageConv5x5Index(3MLIB)
2
3
4

NAME

6       mlib_ImageConv5x5Index - 5x5 convolution on a color indexed image
7

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

46       The function takes the following arguments:
47
48       dst         Pointer to destination image.
49
50
51       src         Pointer to source image.
52
53
54       kernel      Pointer to the convolution kernel, in row major order.
55
56
57       scale       Scaling factor.
58
59
60       edge        Type of edge condition. It can be one of the following:
61
62                     MLIB_EDGE_DST_NO_WRITE
63                     MLIB_EDGE_DST_FILL_ZERO
64                     MLIB_EDGE_DST_COPY_SRC
65                     MLIB_EDGE_SRC_EXTEND
66
67
68
69       colormap    Internal data structure for  inverse  color  mapping.  This
70                   data   structure   is   generated   by  the  mlib_ImageCol‐
71                   orTrue2IndexInit() function.
72
73

RETURN VALUES

75       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
76       MLIB_FAILURE.
77

ATTRIBUTES

79       See attributes(5) for descriptions of the following attributes:
80
81
82
83
84       ┌─────────────────────────────┬─────────────────────────────┐
85       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
86       ├─────────────────────────────┼─────────────────────────────┤
87       │Interface Stability          │Committed                    │
88       ├─────────────────────────────┼─────────────────────────────┤
89       │MT-Level                     │MT-Safe                      │
90       └─────────────────────────────┴─────────────────────────────┘
91

SEE ALSO

93       mlib_ImageConv2x2(3MLIB),    mlib_ImageConv2x2_Fp(3MLIB),   mlib_Image‐
94       Conv2x2Index(3MLIB),       mlib_ImageConv3x3(3MLIB),        mlib_Image‐
95       Conv3x3_Fp(3MLIB),      mlib_ImageConv3x3Index(3MLIB),      mlib_Image‐
96       Conv4x4(3MLIB),        mlib_ImageConv4x4_Fp(3MLIB),         mlib_Image‐
97       Conv4x4Index(3MLIB),        mlib_ImageConv5x5(3MLIB),       mlib_Image‐
98       Conv5x5_Fp(3MLIB),        mlib_ImageConv7x7(3MLIB),         mlib_Image‐
99       Conv7x7_Fp(3MLIB), mlib_ImageConv7x7Index(3MLIB), mlib_ImageConvKernel‐
100       Convert(3MLIB), mlib_ImageConvMxN(3MLIB),  mlib_ImageConvMxN_Fp(3MLIB),
101       mlib_ImageConvMxNIndex(3MLIB),            mlib_ImageConvolveMxN(3MLIB),
102       mlib_ImageConvolveMxN_Fp(3MLIB),             mlib_ImageSConv3x3(3MLIB),
103       mlib_ImageSConv3x3_Fp(3MLIB),                mlib_ImageSConv5x5(3MLIB),
104       mlib_ImageSConv5x5_Fp(3MLIB),                mlib_ImageSConv7x7(3MLIB),
105       mlib_ImageSConv7x7_Fp(3MLIB),      mlib_ImageSConvKernelConvert(3MLIB),
106       attributes(5)
107
108
109
110SunOS 5.11                        2 Mar 2007     mlib_ImageConv5x5Index(3MLIB)
Impressum