Performs top-hat operation on an image.
Syntax
IppStatus ippiMorphTophatBorder_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, IppiBorderType borderType, IppiMorphAdvState* pState);
Supported values for mod:
| 8u_C1R | 32f_C1R |
| 8u_C3R | 32f_C3R |
| 8u_C4R | 32f_C4R |
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 destination image ROI. |
dstStep |
Distance in bytes between starts of consecutive lines in the destination image. |
roiSize |
Size of the source and destination image ROI. |
borderType |
Type of border; the possible value is ippBorderRepl, which means that a replicated border is used. |
pState |
Pointer to the morphology state structure. |
Description
The function ippiMorphTophatBorder is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function perfoms a top-hat operation on a rectangular ROI area inside a one-, three-, or four-channel 2D image using a specified in the advanced morphology state structure pState mask and the anchor cell. This structure must be initialized by the functions MorphAdvInitAlloc or MorphAdvInit beforehand.
The result is equivalent to the opening the source image and following subtraction from the initial source image.
Warning
The function can process only images with ROI that does not exceed the maximum width and height roiSize specified by the initialization functions.
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 roiSize has a field with a zero or negative value, or if one of ROI width or height is greater than corresponding size of ROI passed to the initialization functions. |
ippStsStepErr |
Indicates an error condition if srcStep or dstStep is less than roiSize.width * <pixelSize>. |
ippStsNotEvenStepErr |
Indicates an error condition if one of the step values is not divisible by 4 for floating-point images. |
ippStsBorderErr |
Indicates an error condition if borderType has an illegal value. |