Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
MorphGradient
Calculates morphological gradient of an image.
Syntax
IppStatus ippiMorphGradient_16u_C1R_L(const Ipp16u* pSrc, IppSizeL srcStep, Ipp16u* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp16u borderValue[1], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_16s_C1R_L(const Ipp16s* pSrc, IppSizeL srcStep, Ipp16s* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp16s borderValue[1], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_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 IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_8u_C1R_L(const Ipp8u* pSrc, IppSizeL srcStep, Ipp8u* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp8u borderValue[1], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_8u_C3R_L(const Ipp8u* pSrc, IppSizeL srcStep, Ipp8u* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp8u borderValue[3], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_8u_C4R_L(const Ipp8u* pSrc, IppSizeL srcStep, Ipp8u* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp8u borderValue[4], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_32f_C1R_L(const Ipp32f* pSrc, IppSizeL srcStep, Ipp32f* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp32f borderValue[1], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_32f_C3R_L(const Ipp32f* pSrc, IppSizeL srcStep, Ipp32f* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp32f borderValue[3], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
IppStatus ippiMorphGradient_32f_C4R_L(const Ipp32f* pSrc, IppSizeL srcStep, Ipp32f* pDst, IppSizeL dstStep, IppiSizeL roiSize, IppiBorderType borderType, const Ipp32f borderValue[4], const IppiMorphAdvStateL* pMorphSpec, Ipp8u* pBuffer);
Include Files
ippcv_l.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 row. |
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 row. |
roiSize |
Size of the source and destination image ROI. |
borderType |
Type of border. Possible values are:
|
borderValue, borderValue[3], borderValue[4] |
Constant value to assign to pixels of the constant border. This parameter is applicable only to the ippBorderConst border type. |
pMorphSpec |
Pointer to the morphology specification structure. |
pBuffer |
Pointer to the external buffer. |
Description
Before using this function, you need to initialize the morphology specification structure using the ippiMorphInit function.
This function calculates a morphological gradient of a rectangular ROI area inside a one-, three-, or four-channel 2D image using a specified in the advanced morphology specification structure mask and anchor cell.
The result is equivalent to the subtraction of an opened source image from a closed source image.
Return Values
ippStsNoErr |
Indicates no error. |
ippStsNullPtrErr |
Indicates an error when one of the specified pointers is NULL. |
ippStsSizeErr |
|
ippStsStepErr |
Indicates an error condition when srcStep or dstStep is less than roiSize.width * <pixelSize>. |
ippStsNotEvenStepErr |
Indicates an error when one of the step values is not a multiple of an element size. |
ippStsBadArgErr |
Indicates an error when borderType has an illegal value. |
See Also
Regions of Interest in Intel IPP
MorphInit Initializes the internal state or specification structure for advanced morphological operations.