1mlib_ImageAutoCorrel(3MLIB)mediaLib Library Functionsmlib_ImageAutoCorrel(3MLIB)
2
3
4
6 mlib_ImageAutoCorrel - auto-correlation of an image
7
9 cc [ flag... ] file... -lmlib [ library... ]
10 #include <mlib.h>
11
12 mlib_status mlib_ImageAutoCorrel(mlib_d64 *correl, const mlib_image *img,
13 mlib_s32 dx, mlib_s32 dy);
14
15
17 The mlib_ImageAutoCorrel() function computes the auto-correlation of an
18 image, given an offset.
19
20
21 It uses the following equation:
22
23 1 w-dx-1 h-dy-1
24 correl[i] = -------------- * SUM SUM (img[x][y][i] * img[x+dx][y+dy][i])
25 (w-dx)*(h-dy) x=0 y=0
26
27
28
29 where w and h are the width and height of the image, respectively.
30
32 The function takes the following arguments:
33
34 correl Pointer to auto-correlation array where size is equal to the
35 number of channels. correl[i] contains the auto-correlation
36 of channel i.
37
38
39 img Pointer to image.
40
41
42 dx Displacement in the X direction.
43
44
45 dy Displacement in the Y direction.
46
47
49 The function returns MLIB_SUCCESS if successful. Otherwise it returns
50 MLIB_FAILURE.
51
53 See attributes(5) for descriptions of the following attributes:
54
55
56
57
58 ┌─────────────────────────────┬─────────────────────────────┐
59 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
60 ├─────────────────────────────┼─────────────────────────────┤
61 │Interface Stability │Committed │
62 ├─────────────────────────────┼─────────────────────────────┤
63 │MT-Level │MT-Safe │
64 └─────────────────────────────┴─────────────────────────────┘
65
67 mlib_ImageAutoCorrel_Fp(3MLIB), mlib_ImageCrossCorrel(3MLIB),
68 mlib_ImageCrossCorrel_Fp(3MLIB), attributes(5)
69
70
71
72SunOS 5.11 2 Mar 2007 mlib_ImageAutoCorrel(3MLIB)