1mlib_ImageConv4x4_Fp(3MLIB)mediaLib Library Functionsmlib_ImageConv4x4_Fp(3MLIB)
2
3
4

NAME

6       mlib_ImageConv4x4_Fp - 4x4 convolution
7

SYNOPSIS

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

DESCRIPTION

17       The  mlib_ImageConv4x4_Fp() function performs a floating-point 4x4 con‐
18       volution on the source image by using the user-supplied kernel.
19
20
21       The input image and the output image must have the same image type  and
22       have the same number of channels. The unselected channels in the output
23       image are not overwritten. For single-channel images, the channel  mask
24       is ignored.
25
26
27       For  this  convolution,  the  key  element of the convolution kernel is
28       located at (1, 1) of the kernel matrix.
29
30
31       It uses the following equation:
32
33                        m-1-dm n-1-dn
34         dst[x][y][i] =  SUM    SUM  src[x+p][y+q][i]*k[p][q]
35                        p=-dm  q=-dn
36
37
38
39       where m = 4, n = 4, dm = (m - 1)/2 = 1, dn = (n - 1)/2 = 1.
40

PARAMETERS

42       The function takes the following arguments:
43
44       dst       Pointer to destination image.
45
46
47       src       Pointer to source image.
48
49
50       kernel    Pointer to the convolution kernel, in row major order.
51
52
53       cmask     Channel mask to indicate the channels to be  convolved,  each
54                 bit  of which represents a channel in the image. The channels
55                 corresponding to bits with a value of 1 are those to be  pro‐
56                 cessed.  For  a  single-channel  image,  the  channel mask is
57                 ignored.
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

RETURN VALUES

70       The function returns MLIB_SUCCESS if successful. Otherwise  it  returns
71       MLIB_FAILURE.
72

ATTRIBUTES

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

SEE ALSO

88       mlib_ImageConv2x2(3MLIB),    mlib_ImageConv2x2_Fp(3MLIB),   mlib_Image‐
89       Conv2x2Index(3MLIB),       mlib_ImageConv3x3(3MLIB),        mlib_Image‐
90       Conv3x3_Fp(3MLIB),      mlib_ImageConv3x3Index(3MLIB),      mlib_Image‐
91       Conv4x4(3MLIB),       mlib_ImageConv4x4Index(3MLIB),        mlib_Image‐
92       Conv5x5(3MLIB),         mlib_ImageConv5x5_Fp(3MLIB),        mlib_Image‐
93       Conv5x5Index(3MLIB),       mlib_ImageConv7x7(3MLIB),        mlib_Image‐
94       Conv7x7_Fp(3MLIB), mlib_ImageConv7x7Index(3MLIB), mlib_ImageConvKernel‐
95       Convert(3MLIB), mlib_ImageConvMxN(3MLIB),  mlib_ImageConvMxN_Fp(3MLIB),
96       mlib_ImageConvMxNIndex(3MLIB),            mlib_ImageConvolveMxN(3MLIB),
97       mlib_ImageConvolveMxN_Fp(3MLIB),             mlib_ImageSConv3x3(3MLIB),
98       mlib_ImageSConv3x3_Fp(3MLIB),                mlib_ImageSConv5x5(3MLIB),
99       mlib_ImageSConv5x5_Fp(3MLIB),                mlib_ImageSConv7x7(3MLIB),
100       mlib_ImageSConv7x7_Fp(3MLIB),      mlib_ImageSConvKernelConvert(3MLIB),
101       attributes(5)
102
103
104
105SunOS 5.11                        2 Mar 2007       mlib_ImageConv4x4_Fp(3MLIB)
Impressum