1mlib_ImageConv2x2Index(3MLImBe)diaLib Library Functiomnlsib_ImageConv2x2Index(3MLIB)
2
3
4

NAME

6       mlib_ImageConv2x2Index - 2x2 convolution on a color indexed image
7

SYNOPSIS

9       cc [ flag... ] file... -lmlib [ library... ]
10       #include <mlib.h>
11
12       mlib_status mlib_ImageConv2x2Index(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_ImageConv2x2Index() function performs a 2x2 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 (0, 0) 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 = 2, n = 2, dm = (m - 1)/2 = 0, dn = (n - 1)/2 = 0.
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.
71
72

RETURN VALUES

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

ATTRIBUTES

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

SEE ALSO

92       mlib_ImageConv2x2(3MLIB),   mlib_ImageConv2x2_Fp(3MLIB),    mlib_Image‐
93       Conv3x3(3MLIB),         mlib_ImageConv3x3_Fp(3MLIB),        mlib_Image‐
94       Conv3x3Index(3MLIB),       mlib_ImageConv4x4(3MLIB),        mlib_Image‐
95       Conv4x4_Fp(3MLIB),      mlib_ImageConv4x4Index(3MLIB),      mlib_Image‐
96       Conv5x5(3MLIB),        mlib_ImageConv5x5_Fp(3MLIB),         mlib_Image‐
97       Conv5x5Index(3MLIB),        mlib_ImageConv7x7(3MLIB),       mlib_Image‐
98       Conv7x7_Fp(3MLIB), mlib_ImageConv7x7Index(3MLIB), mlib_ImageConvKernel‐
99       Convert(3MLIB),  mlib_ImageConvMxN(3MLIB), mlib_ImageConvMxN_Fp(3MLIB),
100       mlib_ImageConvMxNIndex(3MLIB),            mlib_ImageConvolveMxN(3MLIB),
101       mlib_ImageConvolveMxN_Fp(3MLIB),             mlib_ImageSConv3x3(3MLIB),
102       mlib_ImageSConv3x3_Fp(3MLIB),                mlib_ImageSConv5x5(3MLIB),
103       mlib_ImageSConv5x5_Fp(3MLIB),                mlib_ImageSConv7x7(3MLIB),
104       mlib_ImageSConv7x7_Fp(3MLIB),      mlib_ImageSConvKernelConvert(3MLIB),
105       attributes(5)
106
107
108
109SunOS 5.11                        2 Mar 2007     mlib_ImageConv2x2Index(3MLIB)
Impressum