Dilate
Performs dilation of an image using a specified mask.
Syntax
IppStatus ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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 ippiDilate_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=MIN_VALUE, whereMIN_VALUE=IPP_MIN_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 dilation 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. 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. 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.