1mlib_ImageConv3x3Index(3MLImBe)diaLib Library Functiomnlsib_ImageConv3x3Index(3MLIB)
2
3
4

NAME

6       mlib_ImageConv3x3Index - 3x3 convolution on a color indexed image
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageConv3x3Index(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_ImageConv3x3Index() function performs a 3x3 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 the center of the kernel matrix.
27
28
29       This  function  performs  the  convolution  on 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 = 3, n = 3, dm = (m - 1)/2 = 1, dn = (n - 1)/2 = 1.
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       scale       Scaling factor.
57
58
59       edge        Type of edge condition. It can be one of the following:
60
61                     MLIB_EDGE_DST_NO_WRITE
62                     MLIB_EDGE_DST_FILL_ZERO
63                     MLIB_EDGE_DST_COPY_SRC
64                     MLIB_EDGE_SRC_EXTEND
65
66
67
68       colormap    Internal  data  structure  for  inverse color mapping. This
69                   data  structure  is   generated   by   the   mlib_ImageCol‐
70                   orTrue2IndexInit()  function.  The  source  and destination
71                   images must be single-channel images.
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_ImageConv4x4(3MLIB),        mlib_Image‐
96       Conv4x4_Fp(3MLIB),      mlib_ImageConv4x4Index(3MLIB),      mlib_Image‐
97       Conv5x5(3MLIB),         mlib_ImageConv5x5_Fp(3MLIB),        mlib_Image‐
98       Conv5x5Index(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_ImageConv3x3Index(3MLIB)
Impressum