Erode
Performs erosion of an image using a specified mask.
Syntax
IppStatus ippiErode_8u_C1R_L(const Ipp8u*
pSrc
, IppSizeL
srcStep
, Ipp8u*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp8u
borderValue[1]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_8u_C3R_L(const Ipp8u*
pSrc
, IppSizeL
srcStep
, Ipp8u*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp8u
borderValue[3]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_8u_C4R_L(const Ipp8u*
pSrc
, IppSizeL
srcStep
, Ipp8u*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp8u
borderValue[4]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_32f_C3R_L(const Ipp32f*
pSrc
, IppSizeL
srcStep
, Ipp32f*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp32f
borderValue[3]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_32f_C1R_L(const Ipp32f*
pSrc
, IppSizeL
srcStep
, Ipp32f*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp32f
borderValue[1]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_32f_C4R_L(const Ipp32f*
pSrc
, IppSizeL
srcStep
, Ipp32f*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp32f
borderValue[4]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_16u_C1R_L(const Ipp16u*
pSrc
, IppSizeL
srcStep
, Ipp16u*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp16u
borderValue[1]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_16s_C1R_L(const Ipp16s*
pSrc
, IppSizeL
srcStep
, Ipp16s*
pDst
, IppSizeL
dstStep
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp16s
borderValue[1]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
IppStatus ippiErode_1u_C1R_L(const Ipp8u*
pSrc
, IppSizeL
srcStep
, int
srcBitOffset
, Ipp8u*
pDst
, IppSizeL
dstStep
, int
dstBitOffset
, IppiSizeL
roiSize
, IppiBorderType
borderType
, const Ipp8u
borderValue[1]
, const IppiMorphStateL*
pMorphSpec
, Ipp8u*
pBuffer
);
Include Files
ippcv_l.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
- pSrc
- Pointer to the source image ROI.
- srcStep
- Distance, in bytes, between the starting points of consecutive lines in the source image.
- pDst
- Pointer to the destination image ROI.
- dstStep
- Distance, in bytes, between the starting points of consecutive lines in the destination image.
- roiSize
- Size of the source and destination ROI, in pixels.
- borderType
- Type of the border; supported values:
- ippBorderDefault
- The border is set toippBorderConstwithborderValue=MAX_VALUE, whereMAX_VALUE=IPP_MAX_8U/16U/16S/32F/1U
- ippBorderRepl
- Border is replicated from the edge pixels.
- ippBorderMirror
- Border pixels are mirrored from the source image boundary pixels.
- ippBorderConst
- Values of all border pixels are set to a constant.
- ippBorderInMem
- Border is obtained from the source image pixels in memory.
Mixed borders are also supported. They can be obtained by the bitwise operationORbetween any of theippBorderRepl,ippBorderConst, orippBorderMirrorvalues and theippBorderInMemTop,ippBorderInMemBottom,ippBorderInMemLeft,ippBorderInMemRightvalues. - borderValue
- Pointer to the vector of values for the constant border type.
- srcBitOffset
- Offset in the first byte of the source image row.
- dstBitOffset
- Offset in the first byte of the destination image row.
- pMorphSpec
- Pointer to the morphology specification structure.
- pBuffer
- Pointer to the external work buffer.
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function performs erosion of a rectangular ROI area inside a one-, three-, or four-channel 2D image using a specified mask
pMask
of size maskSize
and alignment anchor
.Source and destination images can be of different sizes, but the ROI size is the same for both images (
dstRoiSize
). The output pixel is set to the minimum of the corresponding input pixel and its neighboring pixels that are picked out by the non-zero mask values. In the four-channel image the alpha channel is not processed.Return Values
- ippStsNoErr
- Indicates no error. Any other value indicates an error or a warning.
- ippStsNullPtrErr
- Indicates an error condition ifpSrcorpDstisNULL.
- ippStsSizeErr
- Indicates an error condition ifroiSizehas a field with a zero or negative value.
- ippStsStepErr
- Indicates an error condition ifsrcStepordstStephas a zero or negative value.
- ippStsNotEvenStepErr
- Indicates an error condition ifsrcStepordstStephas a not pixel multiple value.
- ippStsBadArgErr
- Indicates an error condition ifborderTypehas an incorrect value.