Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
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.
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.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804