Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference

ID 790148
Date 10/31/2024
Public
Document Table of Contents

MorphGrayInit

Initializes morphology state structure for gray-kernel morphology operations.

Syntax

IppStatus ippiMorphGrayInit_8u_C1R(IppiMorphGrayState_8u* pState, IppiSize roiSize, const Ipp32s* pMask, IppiSize maskSize, IppiPoint anchor);

IppStatus ippiMorphGrayInit_32f_C1R(IppiMorphGrayState_32f* pState, IppiSize roiSize, const Ipp32f* pMask, IppiSize maskSize, IppiPoint anchor);

Include Files

ippcv.h

Domain Dependencies

Headers: ippcore.h, ippvm.h, ipps.h, ippi.h

Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib

Parameters

pState

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

This function operates with ROI (see Regions of Interest in Intel IPP).

This function initializes the gray-kernel morphology state structure pState in the external buffer. Its size should be computed by the function MorphGrayGetSize. 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.