Computes normalized Euclidean distance between an image and a template.
Syntax
Case 1: Operation with integer output
IppStatus ippiSqrDistanceValid_Norm_<mod>(const Ipp8u* pSrc, int srcStep, IppiSize srcRoiSize, const Ipp8u* pTpl, int tplStep, IppiSize tplRoiSize, Ipp8u* pDst, int dstStep, int scaleFactor);
Supported values for mod:
8u_C1RSfs |
8u_C3RSfs |
8u_C4RSfs |
8u_AC4RSfs |
Case 2: Operation on data with floating-point output
IppStatus ippiSqrDistanceValid_Norm_<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 |
32f_C3R |
8u32f_C3R |
8s32f_C3R |
16u32f_C3R |
32f_C4R |
8u32f_C4R |
8s32f_C4R |
16u32f_C4R |
32f_AC4R |
8u32f_AC4R |
8s32f_AC4R |
16u32f_AC4R |
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. |
scaleFactor |
Scale factor (see Integer Result Scaling). |
Description
The function ippiSqrDistanceValid_Norm is declared in the ippi.h file. It operates with ROI (see Regions of Interest in Intel IPP). This function computes the normalized SSD values σtx(r,c) for the pixels of the source image without zero-padded edges. The size of the resulting matrix with normalized SSD 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 σtx(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. |