Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
TrueDistanceTransform
Calculates the Eucledian distance to the closest zeropixel for all non-zero pixels of the source image.
Syntax
IppStatus ippiTrueDistanceTransform_8u32f_C1R(constIpp8u* pSrc, int srcStep, Ipp32f* pDst, int dstStep,IppiSize roiSize, Ipp8u* pBuffer);
Include Files
ippcv.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h, ippi.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib
Parameters
- pSrc
-
Pointer to the sourceimage ROI.
- srcStep
-
Distance in bytesbetween starts of consecutive lines in the source image.
- pDst
-
Pointer to the ROIin the destination distance image.
- dstStep
-
Distance in bytesbetween starts of consecutive lines in the destination image.
- roiSize
-
Size of the imageROI in pixels.
- pBuffer
-
Pointer to the temporaryworking buffer.
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function calculates the Eucledian distance to the closest zero pixel for all non-zero pixels of the source image [Felz04].
The figure below shows the result of the integer version of the true distance transform of a 7x7 image with zero point in the center and with the scale factor -5.
136 |
115 |
101 |
96 |
101 |
115 |
136 |
115 |
91 |
72 |
64 |
72 |
91 |
115 |
101 |
72 |
45 |
36 |
45 |
72 |
101 |
96 |
64 |
36 |
0 |
36 |
64 |
96 |
101 |
72 |
45 |
36 |
45 |
72 |
101 |
115 |
91 |
72 |
64 |
72 |
91 |
115 |
136 |
115 |
101 |
96 |
101 |
115 |
136 |
Return Values
ippStsNoErr |
Indicates no error. Any othervalue indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error conditionif one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error conditionif roiSize has a field withzero or negative value. |
ippStsStepErr |
Indicates an error conditionif srcStep or dstStep is less than roiSize.width*<pixelSize>. |
ippStsNotEvenStepErr |
Indicates an error conditionif step value is not divisible by 2 for 16u images,and by 4 for 32f images. |