Allocates and initializes morphology state structure for gray-kernel morphology operations.
Syntax
IppStatus ippiMorphGrayInitAlloc_8u_C1R(IppiMorphGrayState_8u** ppState, IppiSize roiSize, const Ipp32s* pMask, IppiSize maskSize, IppiPoint anchor);
IppStatus ippiMorphGrayInitAlloc_32f_C1R(IppiMorphGrayState_32f** ppState, IppiSize roiSize, const Ipp32f* pMask, IppiSize maskSize, IppiPoint anchor);
Parameters
ppState |
Double pointer to the gray-kernel 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 ippiMorphGrayInitAlloc is declared in the ippcv.h file. It operates with ROI (see Regions of Interest in Intel IPP).
This function allocates memory, initializes the gray-kernel morphology state structure and returns the pointer ppState to it. It is used by the functions GrayDilateBorder and GrayErodeBorder that perform gray-kernel dilation and erosion of the source image pixels corresponding to the specified pMask of size maskSize. The anchor cell anchor is positioned in the arbitrary point in the mask and is used for positioning the mask.
Warning
The structure 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. |