Developer Reference for Intel® Integrated Performance Primitives 2019
Marks small noise blobs (speckles) in an image.
IppStatus ippiMarkSpeckles_<mod>(Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize, Ipp<datatype> speckleVal, int maxSpeckleSize, Ipp<datatype> maxPixDiff, IppiNorm norm, Ipp8u* pBuffer);
Supported values for mod:
8u_C1IR | 16u_C1IR | 16s_C1IR | 32f_C1IR |
ippcv.h
Headers: ippcore.h, ippvm.h, ipps.h, ippi.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib
pSrcDst |
Pointer to the source and destination image. |
||
srcDstStep |
Distance, in bytes, between the starting points of consecutive lines in the source and destination image. |
||
roiSize |
Size of the source and destination image ROI in pixels. |
||
speckleVal |
Value to set to the speckles. |
||
maxSpeckleSize |
Maximum size of the image component to consider it as a speckle. |
||
maxPixDiff |
Maximum difference between neighboring disparity pixels to put them into the same component. |
||
norm |
Type of the norm to form the mask for marker propagation. Possible value is:
|
||
pBuffer |
Pointer to the work buffer. |
This function operates with ROI (see Regions of Interest in Intel IPP).
This function marks small noise blobs (speckles) in the source image.
The pSrcDst parameter points to the processed source and destination image ROI.
The function finds small connected components and set them to the speckleVal value. This function marks only components with size that is less than, or equal to maxSpeckleSize. Pixels of the image belong to the same connected component if the difference between adjacent pixels (considering 4-connected adjacency) is less than, or equal to the maxSpeckleSize value.
This release does not support 8-connectivity.
The function does not process the pixels of the image that already have the speckleVal value.
Before using the ippiMarkSpeckles function, compute the size of the external buffer using the MarkSpecklesGetBufferSize function.
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when pSrcDst or pBufferSize is NULL. |
ippStsSizeErr |
Indicates an error when roiSize has a field with a zero or negative value. |
ippStsNotEvenStepErr |
Indicates an error when one of the step values is not divisible by 4 for floating-point images, or by 2 for short-integer images. |
ippStsNormErr |
Indicates an error when norm has an incorrect or not supported value. |