TrueDistanceTransform
Calculates the Eucledian distance to the closest zero
pixel for all non-zero pixels of the source image.
Syntax
IppStatus ippiTrueDistanceTransform_8u32f_C1R(const
Ipp8u*
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 source image ROI.
- srcStep
- Distance in bytes between starts of consecutive lines in the source image.
- pDst
- Pointer to the ROI in the destination distance image.
- dstStep
- Distance in bytes between starts of consecutive lines in the destination image.
- roiSize
- Size of the image ROI in pixels.
- pBuffer
- Pointer to the temporary working 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 other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error condition if one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with zero or negative value.
- ippStsStepErr
- Indicates an error condition ifsrcStepordstStepis less thanroiSize.width*<pixelSize>.
- ippStsNotEvenStepErr
- Indicates an error condition if step value is not divisible by 2 for16uimages, and by 4 for32fimages.