Computes cross-correlation between an image and a template.
Syntax
IppStatus ippiCrossCorrValid_<mod>(const Ipp<srcDatatype>* pSrc, int srcStep, IppiSize srcRoiSize, const Ipp<srcDatatype>* pTpl, int tplStep, IppiSize tplRoiSize, Ipp32f* pDst, int dstStep);
Supported values for mod:
32f_C1R |
8u32f_C1R |
8s32f_C1R |
16u32f_C1R |
Parameters
pSrc |
Pointer to the source image ROI. |
srcStep |
Distance in bytes between starts of consecutive lines in the source image. |
srcRoiSize |
Size of the source ROI in pixels. |
pTpl |
Pointer to the template image buffer. |
tplStep |
Distance in bytes between starts of consecutive lines in the template image. |
tplRoiSize |
Size of the template ROI in pixels. |
pDst |
Pointer to the destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
Description
The function ippiCrossCorrValid is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP). This function computes the cross-correlation values Rtx(r,c) for the pixels of the source image without zero-padded edges. The size of the resulting matrix with cross-correlation values is
(Ws - Wt + 1) * (Hs - Ht + 1),
where Ws , Hs denote the width and height of the source image, and Wt , Ht denote the width and height of the template. The template anchor for matching the image pixel is always at the geometric center of the template. (See the formula for Rtx(r,c) in section Image Proximity Measures).
Note
For multi-channel images, each channel is processed separately.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error when any of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition when srcRoiSize or tplRoiSize has a field with zero or negative value, or when srcRoiSize has a field with value smaller than value of the corresponding field of tplRoiSize. |
ippStsStepErr |
Indicates an error condition if at least one of srcStep, tplStep, or dstStep has a zero or negative value. |
ippStsMemAllocErr |
Indicates an error condition if memory allocation fails. |