Intel® Integrated Performance Primitives (Intel® IPP) Developer Guide and Reference
A newer version of this document is available. Customers should click here to go to the newest version.
AbsDiffC
Calculates absolute difference between image and scalar value.
Syntax
IppStatus ippiAbsDiffC_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, int value);
Supported values for mod:
| 8u_C1R | 16u_C1R | 
IppStatus ippiAbsDiffC_32f_C1R(const Ipp32f* pSrc, int srcStep, Ipp32f* pDst, int dstStep, IppiSize roiSize, Ipp32f value);
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. | 
| srcStep | Distance in bytes between starts of consecutive lines in the source image. | 
| pDst | Pointer to the destination image. | 
| dstStep | Distance in bytes between starts of consecutive lines in the destination image. | 
| roiSize | Size of the image ROI in pixels. | 
| value | Scalar value used to decrement each element of the source image. | 
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function calculates the absolute pixel-wise difference between the source image pSrc and the scalar value by the formula:
pDst(x,y) = abs(pSrc(x,y) - value.
The function clips the value to the range [0, 255] for the 8u data type, and to the range [0, 65535] for the 16u data type.
Return Values
| ippStsNoErr | Indicates no error. | 
| ippStsNullPtrErr | Indicates an error condition if one of the specified pointers is NULL. | 
| ippStsSizeErr | Indicates an error condition if roiSize has a field with zero or negative value. | 
| ippStsStepErr | Indicates an error when srcStep or dstStep is less than roiSize.width * <pixelSize>. | 
| ippStsNotEvenStepErr | Indicates an error condition if one of step values for floating-point images cannot be divided by 4. |