Initializes morphology state structure for advanced morphology operations.
Syntax
IppStatus ippiMorphologyInit_<mod>(IppiMorphAdvState* pState, IppiSize roiSize, const Ipp8u* pMask, IppiSize maskSize, IppiPoint anchor);
Supported values for mod:
| 8u_C1R | 32f_C1R |
| 8u_C3R | 32f_C3R |
| 8u_C4R | 32f_C4R |
Parameters
pState |
Pointer to the advanced morphology state structure. |
roiSize |
Maximal size of the image ROI in pixels, that can be processed using the allocated structure. |
pMask |
Pointer to the mask. |
maskSize |
Size of the mask in pixels. |
anchor |
Coordinates of the anchor cell. |
Description
The function ippiMorphAdvInit is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP ).
This function initializes the advanced morphology state structure pState in the external buffer. Its size should be computed by the function MorphAdvGetSize. ippiMorphAdvInit is used by the functions MorphOpenBorder, MorphCloseBorder, MorphTophatBorder, MorphBlackhatBorder, and MorphGradientBorder that perform advanced morphological operations (opening, closing, top-hat, black-hat, and gradient) on the source image pixels corresponding to non-zero values of the structuring element (mask) pMask. The anchor cell anchor is positioned in the arbitrary point in the structuring element and is used for positioning the structuring element.
Warning
The function can be used to process images with ROI that does not exceed the specified maximum width and height roiSize.
Return Values
ippStsNoErr |
Indicates no error. Any other value indicates an error or a warning. |
ippStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
ippStsSizeErr |
Indicates an error condition if maskSize or if roiSize has a field with a zero or negative value. |
ippStsAnchorErr |
Indicates an error if anchor is outside the mask. |