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

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

MorphologyBorderInit

Initializes the morphology specification structure for erosion or dilation operations.

Syntax

IppStatus ippiMorphologyBorderInit_<mod>(IppiSize roiSize, const Ipp8u* pMask, IppiSize maskSize, IppiMorphState* pSpec, Ipp8u* pBuffer);

Supported values for mod:

1u_C1R 8u_C1R 16u_C1R 16s_C1R 32f_C1R
  8u_C3R     32f_C3R
  8u_C4R     32f_C4R

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

roiSize

Size of the image ROI, in pixels.

pMask

Pointer to the mask.

maskSize

Size of the mask, in pixels.

pSpec

Pointer to the specification structure.

pBuffer

Pointer to the external buffer required for dilation or erosion operations.

Description

This function operates with ROI.

This function initializes the specification structure pSpec in the external buffer. Before using this function, you need to compute the size of the specification structure using the MorphologyBorderGetSize function. This structure is used by the ippiDilateBorder and ippiErodeBorder functions that perform morphological operations on the source image pixels corresponding to non-zero values of the structuring element (mask) pMask.

Return Values

ippStsNoErr

Indicates no error.

ippStsNullPtrErr

Indicates an error when one of the specified pointers is NULL.

ippStsSizeErr

Indicates an error when maskSize has a field with a zero or negative value, or if width or height of roiSize is less than 1.

See Also