mlib_imageautocorrel_fp(3mlib) [opensolaris man page]
mlib_ImageAutoCorrel_Fp(3MLIB) mediaLib Library Functions mlib_ImageAutoCorrel_Fp(3MLIB)NAME
mlib_ImageAutoCorrel_Fp - auto-correlation of an image
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_ImageAutoCorrel_Fp(mlib_d64 *correl,
const mlib_image *img, mlib_s32 dx, mlib_s32 dy);
DESCRIPTION
The mlib_ImageAutoCorrel_Fp() function computes the auto-correlation of a floating-point image, given an offset.
It uses the following equation:
1 w-dx-1 h-dy-1
correl[i] = -------------- * SUM SUM (img[x][y][i] * img[x+dx][y+dy][i])
(w-dx)*(h-dy) x=0 y=0
where w and h are the width and height of the image, respectively.
PARAMETERS
The function takes the following arguments:
correl Pointer to auto-correlation array where size is equal to the number of channels. correl[i] contains the auto-correlation of chan-
nel i.
img Pointer to image.
dx Displacement in the X direction.
dy Displacement in the Y direction.
RETURN VALUES
The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Committed |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO mlib_ImageAutoCorrel(3MLIB), mlib_ImageCrossCorrel(3MLIB), mlib_ImageCrossCorrel_Fp(3MLIB), attributes(5)SunOS 5.11 2 Mar 2007 mlib_ImageAutoCorrel_Fp(3MLIB)
Check Out this Related Man Page
mlib_SignalAutoCorrel_S16(3MLIB) mediaLib Library Functions mlib_SignalAutoCorrel_S16(3MLIB)NAME
mlib_SignalAutoCorrel_S16, mlib_SignalAutoCorrel_S16S, mlib_SignalAutoCorrel_F32, mlib_SignalAutoCorrel_F32S - signal auto-correlation
SYNOPSIS
cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>
mlib_status mlib_SignalAutoCorrel_S16(mlib_d64 *correl,
const mlib_s16 *src, mlib_s32 disp, mlib_s32 n);
mlib_status mlib_SignalAutoCorrel_S16S(mlib_d64 *correl,
const mlib_s16 *src, mlib_s32 disp, mlib_s32 n);
mlib_status mlib_SignalAutoCorrel_F32(mlib_d64 *correl,
const mlib_f32 *src, mlib_s32 disp, mlib_s32 n);
mlib_status mlib_SignalAutoCorrel_F32S(mlib_d64 *correl,
const mlib_f32 *src, mlib_s32 disp, mlib_s32 n);
DESCRIPTION
Each of these functions performs auto-correlation.
For monaural signals, the following equation is used:
1 n-d-1
correl[0] = ----- * SUM (src[i] * src[i + d])
n - d i=0
For stereo signals, the following equation is used:
1 n-d-1
correl[0] = ----- * SUM (src[2*i] * src[2*(i + d)])
n - d i=0
1 n-d-1
correl[1] = ----- * SUM (src[2*i + 1] * src[2*(i + d) + 1])
n - d i=0
where d = disp.
PARAMETERS
Each of the functions takes the following arguments:
correl Pointer to the auto-correlation array. In the stereo version, correl[0] contains the auto-correlation of channel 0, and correl[1]
contains the auto-correlation of channel 1.
src Source signal array.
disp Displacement. 0 <= disp < n.
n Number of samples in the source signal array.
RETURN VALUES
Each of the functions returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Committed |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO mlib_SignalCrossCorrel_S16(3MLIB), attributes(5)SunOS 5.11 2 Mar 2007 mlib_SignalAutoCorrel_S16(3MLIB)