ErodeBorder
Performs erosion of an image.
Syntax
IppStatus ippiErodeBorder_<mod>(const Ipp<datatype>*
pSrc
, int
srcStep
, Ipp<datatype>*
pDst
, int
dstStep
, IppiSize
roiSize
, IppiBorderType
borderType
, Ipp<datatype>
borderValue
, const IppiMorphState*
pSpec
, Ipp8u*
pBuffer
);
Supported values for
mod
:8u_C1R | 16u_C1R | 16s_C1R | 32f_C1R |
IppStatus ippiErodeBorder_<mod>(const Ipp<datatype>*
pSrc
, int
srcStep
, Ipp<datatype>*
pDst
, int
dstStep
, IppiSize
roiSize
, IppiBorderType
borderType
, const Ipp<datatype>
borderValue[3]
, const IppiMorphState*
pSpec
, Ipp8u*
pBuffer
);
Supported values for
mod
:8u_C3R | 32f_C3R |
IppStatus ippiErodeBorder_<mod>(const Ipp<datatype>*
pSrc
, int
srcStep
, Ipp<datatype>*
pDst
, int
dstStep
, IppiSize
roiSize
, IppiBorderType
borderType
, const Ipp<datatype>
borderValue[4]
, const IppiMorphState*
pSpec
, Ipp8u*
pBuffer
);
Supported values for
mod
:8u_C4R | 32f_C4R |
IppStatus ippiErodeBorder_1u_C1R(const Ipp8u*
pSrc
, int
srcStep
, int
srcBitOffset
, Ipp8u*
pDst
, int
dstStep
, int
dstBitOffset
, IppiSize
roiSize
, IppiBorderType
borderType
, Ipp8u
borderValue
, const IppiMorphState*
pSpec
, Ipp8u*
pBuffer
);
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
- pSrc
- Pointer to the source image ROI.
- srcStep
- Distance, in bytes, between the starting points of consecutive lines in the source image.
- srcBitOffset
- Offset, in bits, from the first byte of the source image (for1u_C1Rflavor).
- pDst
- Pointer to the destination image ROI.
- dstStep
- Distance, in bytes, between the starting points of consecutive lines in the destination image.
- dstBitOffset
- Offset, in bits, from the first byte of the destination image (for1u_C1Rflavor).
- roiSize
- Size of the source and destination image ROI.
- borderType
- Type of border. Possible values are:
- ippBorderRepl
- Border is replicated from the edge pixels.
- ippBorderInMem
- Border is obtained from the source image pixels in memory.
- borderValue
- Constant value to assign to pixels of the constant border. This parameter is applicable only to theippBorderConstborder type.
- pSpec
- Pointer to the specification structure.
- pBuffer
- Pointer to the external buffer required for erosion operations.
Description
This function operates with ROI.
This function performs erosion of a rectangular ROI area inside a one-channel 2D image using a mask specified in the specification structure
pSpec
. Before using this function, you need to initialize the structure using the MorphologyBorderInit
function. The output pixel is set to the maximum of the corresponding input pixel and its neighboring pixels that are picked out by the nonzero mask values.
Return Values
- ippStsNoErr
- Indicates no error.
- ippStsNullPtrErr
- Indicates an error when one of the specified pointers isNULL.
- ippStsSizeErr
- Indicates an error when:
- roiSizehas a field with a zero or negative value
- roiSize.widthis more than the maximum ROIroiWidthpassed to the initialization function
- srcBitOffsetordstBitOffsetis less than zero
- ippStsStepErr
- Indicates an error whensrcStepordstStepis less thanroiSize.width*<pixelSize>.
- ippStsNotEvenStepErr
- Indicates an error when one of the step values for 16-bit integer images is not divisible by 2.
- ippStsBorderErr
- Indicates an error whenborderTypehas an illegal value.
- ippStsInplaceModeNotSupportedErr
- Indicates an error when thepSrcpointer is equal to thepDstpointer.