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.
AndC
Performs a bitwise AND operation of each pixel with a constant.
Syntax
Case 1: Not-in-place operation on one-channel data
IppStatus ippiAndC_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype> value, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C1R | 16u_C1R | 32s_C1R | 
Case 2: Not-in-place operation on multi-channel data
IppStatus ippiAndC_<mod>(const Ipp<datatype>* pSrc, int srcStep, const Ipp<datatype> value[3], Ipp<datatype>* pDst, int dstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C3R | 16u_C3R | 32s_C3R | 
| 8u_AC4R | 16u_AC4R | 32s_AC4R | 
IppStatus ippiAndC_<mod>(const Ipp<datatype>* pSrc, int srcStep, const Ipp<datatype> value[4], Ipp<datatype>* pDst, int dstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C4R | 16u_C4R | 32s_C4R | 
Case 3: In-place operation on one-channel data
IppStatus ippiAndC_<mod>(Ipp<datatype> value, Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C1IR | 16u_C1IR | 32s_C1IR | 
Case 4: In-place operation on multi-channel data
IppStatus ippiAndC_<mod>(const Ipp<datatype> value[3], Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C3IR | 16u_C3IR | 32s_C3IR | 
| 8u_AC4IR | 16u_AC4IR | 32s_AC4IR | 
IppStatus ippiAndC_<mod>(const Ipp<datatype> value[4], Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize);
Supported values for mod:
| 8u_C4IR | 16u_C4IR | 32s_C4IR | 
Include Files
ippi.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 starts of consecutive lines in the source image. | 
| value | The constant value to perform the bitwise AND operation on each pixel of the source image ROI (constant vector in case of multi-channel images). | 
| pDst | Pointer to the destination image ROI. | 
| dstStep | Distance in bytes between starts of consecutive lines in the destination image. | 
| pSrcDst | Pointer to the source and destination image ROI for the in-place operation. | 
| srcDstStep | Distance in bytes between starts of consecutive lines in the source and destination image buffer for the in-place operation. | 
| roiSize | Size of the source and destination ROI in pixels. | 
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function performs a bitwise AND operation between each pixel value of a source image ROI and constant value.
Note that the functions with the AC4 descriptor do not process alpha channels.
Return Values
| ippStsNoErr | Indicates no error. Any other value indicates an error or a warning. | 
| ippStsNullPtrErr | Indicates an error condition if one of the specified pointers is NULL. | 
| ippStsSizeErr | Indicates an error condition if roiSize has a field with a zero or negative value. | 
| ippStsStepErr | Indicates an error condition if srcStep, dstStep, or srcDstStep has a zero or negative value. |