Visible to Intel only — GUID: GUID-F8EE2B4B-DCF8-4BAB-92D8-A200C7A72DBF
iwiFilterMorphology
Syntax
typedef struct _IwiFilterMorphologyParams
{
int iterations;
} IwiFilterMorphologyParams;
static IW_INLINE void iwiFilterMorphology_SetDefaultParams(
IwiFilterMorphologyParams *pParams
)
IW_DECL(IppStatus) iwiFilterMorphology(
const IwiImage *pSrcImage,
IwiImage *pDstImage,
IwiMorphologyType morphType,
const IwiImage *pMaskImage,
const IwiFilterMorphologyParams *pAuxParams,
IppiBorderType border,
const Ipp64f *pBorderVal,
const IwiTile *pTile
);
Parameters
pSrcImage |
Pointer to the source image. |
||||||||||
pDstImage |
Pointer to the destination image. |
||||||||||
morphType |
Type of the morphological filter. |
||||||||||
pMaskImage |
Pointer to the morphology mask image. Mask must be continuous, 8-bit, 1-channel image. |
||||||||||
pAuxParams |
Pointer to the auxiliary parameters structure. If NULL, default parameters are used. |
||||||||||
border |
Extrapolation algorithm for out of image pixels processing. Supported values:
|
||||||||||
pBorderVal |
Pointer to an array of values to assign to pixels of the constant border, one element of the array for each channel of the image. This parameter is applicable only to the ippBorderConst border type and can be NULL for other border types. |
||||||||||
pTile |
Pointer to the IwiTile structure for tiling. If NULL, the whole image is processed. |
Auxiliary Arguments
Argument | Default Value | Description |
---|---|---|
iterations |
1 |
Number of repeated morphology operations to apply. |
Description
This function applies a morphological filter of the specified type and kernel size to the source image. The values of border pixels are assigned in accordance with the border and pBorderValue parameters.
This function supports the following features:
Feature | Support |
---|---|
Internal threading | No |
Manual tiling | Yes |
IwiTile simple tiling | Yes |
IwiTile pipeline tiling | Yes |
Return Values
ippStsNoErr |
No errors. |
ippStsNotSupportedModeErr |
Specified combination of parameters' values is not supported. |
ippStsMaskSizeErr |
The kernel value is illegal. |
ippStsDataTypeErr |
The dataType value is illegal. |
ippStsNumChannelsErr |
The channels value is illegal. |
ippStsNotEvenStepErr |
The srcStep and/or dstStep value is not divisible by size of elements. |
ippStsBorderErr |
The border value is illegal. |
ippStsNoMemErr |
Failed to allocate memory. |
ippStsSizeErr |
Values of the size fields are illegal. |
ippStsInplaceModeNotSupportedErr |
In-place operation is not supported: pSrc is equal to pDst. |
ippStsNullPtrErr |
At least one of the pointers (except pTile) is NULL. |