1mlib_ImageConv4x4(3MLIB)  mediaLib Library Functions  mlib_ImageConv4x4(3MLIB)
2
3
4

NAME

6       mlib_ImageConv4x4 - 4x4 convolution
7

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

43       The function takes the following arguments:
44
45       dst       Pointer to destination image.
46
47
48       src       Pointer to source image.
49
50
51       kernel    Pointer to the convolution kernel, in row major order.
52
53
54       scale     Scaling factor.
55
56
57       cmask     Channel mask to indicate the channels to be  convolved,  each
58                 bit  of which represents a channel in the image. The channels
59                 corresponding to bits with a value of 1 are those to be  pro‐
60                 cessed.  For  a  single-channel  image,  the  channel mask is
61                 ignored.
62
63
64       edge      Type of edge condition. It can be one of the following:
65
66                   MLIB_EDGE_DST_NO_WRITE
67                   MLIB_EDGE_DST_FILL_ZERO
68                   MLIB_EDGE_DST_COPY_SRC
69                   MLIB_EDGE_SRC_EXTEND
70
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       Conv2x2Index(3MLIB),       mlib_ImageConv3x3(3MLIB),        mlib_Image‐
94       Conv3x3_Fp(3MLIB),      mlib_ImageConv3x3Index(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_ImageConv4x4(3MLIB)
Impressum