Performs black-hat operation on an image.
Syntax
IppStatus ippiMorphBlackhatBorder_<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 ippiMorphBlackhatBorder is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function performs black-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 anchor cell. This structure must be initialized by the functions MorphAdvInitAlloc or MorphAdvInit beforehand.
The result is equivalent to the subtraction of the initial source image from the closed 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. |