Developer Reference for Intel® Integrated Performance Primitives 2019

Canny

Implements Canny algorithm for edge detection.

Syntax

IppStatus ippiCanny_16s8u_C1R(Ipp16s* pSrcDx, int srcDxStep, Ipp16s* pSrcDy, int srcDyStep, Ipp8u* pDstEdges, int dstEdgeStep, IppiSize roiSize, Ipp32f lowThreshold, Ipp32f highThreshold, Ipp8u* pBuffer);

IppStatus ippiCanny_32f8u_C1R(Ipp32f* pSrcDx, int srcDxStep, Ipp32f* pSrcDy, int srcDyStep, Ipp8u* pDstEdges, int dstEdgeStep, IppiSize roiSize, Ipp32f lowThreshold, Ipp32f highThreshold, Ipp8u* pBuffer);

Platform-aware functions

IppStatus ippiCanny_16s8u_C1R_L(Ipp16s* pSrcDx, IppSizeL srcDxStep, Ipp16s* pSrcDy, IppSizeL srcDyStep, Ipp8u* pDstEdges, IppSizeL dstEdgeStep, IppiSizeL roiSize, Ipp32f lowThreshold, Ipp32f highThreshold, IppNormType norm, Ipp8u* pBuffer);

IppStatus ippiCanny_32f8u_C1R_L(Ipp32f* pSrcDx, IppSizeL srcDxStep, Ipp32f* pSrcDy, IppSizeL srcDyStep, Ipp8u* pDstEdges, IppSizeL dstEdgeStep, IppiSizeL roiSize, Ipp32f lowThreshold, Ipp32f highThreshold, IppNormType norm, Ipp8u* pBuffer);

Include Files

ippcv.h

Flavors with the _L suffix: ippcv_l.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

pSrcDx
Pointer to the source image ROI x-derivative.
srcDxStep
Distance in bytes between starts of consecutive lines in the source image pSrcDx.
pSrcDy
Pointer to the source image ROI y-derivative.
srcDyStep
Distance, in bytes, between the starting points of consecutive lines in the source image pSrcDy.
pDstEdges
Pointer to the output array of the detected edges.
dstEdgeStep
Distance, in bytes, between the starting points of consecutive lines in the output image.
roiSize
Size of the source image ROI in pixels.
lowThreshold
Lower threshold for edges detection.
highThreshold
Upper threshold for edges detection.
norm
Normalization type; supported values: ippNormL1 and ippNormL2.
pBuffer
Pointer to the pre-allocated temporary buffer.

Description

This function operates with ROI (see Regions of Interest in Intel IPP). This function finds edges in the source image ROI and stores them into the output image pDstEdges using the Canny algorithm. The function requires a temporary working buffer; its size should be computed previously by calling the function ippiCannyGetSize.

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 is NULL.

ippStsSizeErr

Indicates an error condition if pRoiSize has a field with zero or negative value.

ippStsStepErr

Indicates an error condition if srcDxStep, srcDyStep or dstEdgeStep is less than roi.width*<pixelSize>.

ippStsBadArgErr

Indicates an error when lowThresh is negative or highThresh is less than lowThresh.

ippStsNotEvenStepErr

Indicates an error condition if one of the step values is not divisible by 2 for 16s images, and by 4 for 32f images.

Example

Canny.c