Visible to Intel only — GUID: GUID-05455426-0197-45B3-B8AB-D6CD6FC108DD
Visible to Intel only — GUID: GUID-05455426-0197-45B3-B8AB-D6CD6FC108DD
Div
Divides pixel values of an image by pixel values of another image.
Syntax
Case 1: Not-in-place operation on integer or complex data
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, int src1Step, const Ipp<datatype>* pSrc2, int src2Step, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, int scaleFactor);
Supported values for mod:
8u_C1RSfs |
16u_C1RSfs |
16s_C1RSfs |
8u_C3RSfs |
16u_C3RSfs |
16s_C3RSfs |
8u_AC4RSfs |
16u_AC4RSfs |
16s_AC4RSfs |
8u_C4RSfs |
16u_C4RSfs |
16s_C4RSfs |
Case 2: Not-in-place operation on floating-point or complex data
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, int src1Step, const Ipp<datatype>* pSrc2, int src2Step, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize);
Supported values for mod:
32f_C1R |
32f_C3R |
32f_AC4R |
32f_C4R |
Case 3: In-place operation on integer or complex data
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize, int scaleFactor);
Supported values for mod:
8u_C1IRSfs |
16u_C1IRSfs |
16s_C1IRSfs |
8u_C3IRSfs |
16u_C3IRSfs |
16s_C3IRSfs |
8u_AC4IRSfs |
16u_AC4IRSfs |
16s_AC4IRSfs |
8u_C4IRSfs |
16u_C4IRSfs |
16s_C4IRSfs |
Case 4: In-place operation on floating-point or complex data
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize);
Supported values for mod:
32f_C1IR |
32f_C3IR |
32f_AC4IR |
32f_C4IR |
Case 5: Not-in-place operation on integer data with platform-aware functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, IppSizeL src1Step, const Ipp<datatype>* pSrc2, IppSizeL src2Step, Ipp<datatype>* pDst, IppSizeL dstStep, IppiSizeL roiSize, int scaleFactor);
Supported values for mod:
8u_C1RSfs_L |
16u_C1RSfs_L |
16s_C1RSfs_L |
8u_C3RSfs_L |
16u_C3RSfs_L |
16s_C3RSfs_L |
8u_AC4RSfs_L |
16u_AC4RSfs_L |
16s_AC4RSfs_L |
8u_C4RSfs_L |
16u_C4RSfs_L |
16s_C4RSfs_L |
Case 6: Not-in-place operation on floating-point data with platform-aware functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, IppSizeL src1Step, const Ipp<datatype>* pSrc2, IppSizeL src2Step, Ipp<datatype>* pDst, IppSizeL dstStep, IppiSizeL roiSize);
Supported values for mod:
32f_C1R_L |
32f_C3R_L |
32f_AC4R_L |
32f_C4R_L |
Case 7: In-place operation on integer data with platform-aware functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, IppSizeL srcStep, Ipp<datatype>* pSrcDst, IppSizeL srcDstStep, IppiSizeL roiSize, int scaleFactor);
Supported values for mod:
8u_C1IRSfs_L |
16u_C1IRSfs_L |
16s_C1IRSfs_L |
8u_C3IRSfs_L |
16u_C3IRSfs_L |
16s_C3IRSfs_L |
8u_AC4IRSfs_L |
16u_AC4IRSfs_L |
16s_AC4IRSfs_L |
8u_C4IRSfs_L |
16u_C4IRSfs_L |
16s_C4IRSfs_L |
Case 8: In-place operation on floating-point data with platform-aware functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, IppSizeL srcStep, Ipp<datatype>* pSrcDst, IppSizeL srcDstStep, IppiSizeL roiSize);
Supported values for mod:
32f_C1IR_L |
32f_C3IR_L |
32f_AC4IR_L |
32f_C4IR_L |
Case 9: Not-in-place operation on integer data with threading layer (TL) functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, IppSizeL src1Step, const Ipp<datatype>* pSrc2, IppSizeL src2Step, Ipp<datatype>* pDst, IppSizeL dstStep, IppiSizeL roiSize, int scaleFactor);
Supported values for mod:
8u_C1RSfs_LT |
16u_C1RSfs_LT |
16s_C1RSfs_LT |
8u_C3RSfs_LT |
16u_C3RSfs_LT |
16s_C3RSfs_LT |
8u_AC4RSfs_LT |
16u_AC4RSfs_LT |
16s_AC4RSfs_LT |
8u_C4RSfs_LT |
16u_C4RSfs_LT |
16s_C4RSfs_LT |
Case 10: Not-in-place operation on floating-point data with TL functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc1, IppSizeL src1Step, const Ipp<datatype>* pSrc2, IppSizeL src2Step, Ipp<datatype>* pDst, IppSizeL dstStep, IppiSizeL roiSize);
Supported values for mod:
32f_C1R_LT |
32f_C3R_LT |
32f_C4R_LT |
32f_AC4R_LT |
Case 11: In-place operation on integer data with TL functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, IppSizeL srcStep, Ipp<datatype>* pSrcDst, IppSizeL srcDstStep, IppiSizeL roiSize, int scaleFactor);
Supported values for mod:
8u_C1IRSfs_LT |
16u_C1IRSfs_LT |
16s_C1IRSfs_LT |
8u_C3IRSfs_LT |
16u_C3IRSfs_LT |
16s_C3IRSfs_LT |
8u_AC4IRSfs_LT |
16u_AC4IRSfs_LT |
16s_AC4IRSfs_LT |
8u_C4IRSfs_LT |
16u_C4IRSfs_LT |
16s_C4IRSfs_LT |
Case 12: In-place operation on floating-point data with TL functions
IppStatus ippiDiv_<mod>(const Ipp<datatype>* pSrc, IppSizeL srcStep, Ipp<datatype>* pSrcDst, IppSizeL srcDstStep, IppiSizeL roiSize);
Supported values for mod:
32f_C1IR_LT |
32f_C3IR_LT |
32f_AC4IR_LT |
32f_C4IR_LT |
Include Files
ippi.h
Flavors with the _LT suffix: ippi_tl.h
Flavors with the _L suffix: ippi_l.h
Domain Dependencies
Flavors declared in ippi.h:
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.lib
Flavors declared in ippi_tl.h:
Libraries: ippcore.lib, ippvm.lib, ipps.lib, ippi.lib, ippcore_tl.lib, ippi_tl.lib
Parameters
pSrc, pSrc1, pSrc2 |
Pointers to the source images ROI. |
srcStep, src1Step, src2Step |
Distances in bytes between starts of consecutive lines in the source 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 for the in-place operation. |
roiSize |
Size of the source and destination ROI in pixels. |
scaleFactor |
Scale factor (see Integer Result Scaling). |
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function divides pixel values of the source buffer pSrc2 by the corresponding pixel values of the buffer pSrc1 and places the result in a destination buffer pDst. For in-place operations, the values in pSrcDst are divided by the values in pSrc and placed into pSrcDst. For complex data, the function processes both real and imaginary parts of pixel values. In case of operations on integer data, the resulting values are scaled by scaleFactor and rounded (not truncated). When the function encounters a zero divisor value, the execution is not interrupted. The function returns the warning message and corresponding result value (see appendix “Handling of Special Cases” for more information).
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 zero or negative value. |
ippStsStepErr |
Indicates an error condition if any of the specified buffer step values is zero or negative. |
ippStsDivByZero |
Indicates a warning that a divisor value is zero. The function execution is continued. |
Example
The code example below illustrates how the function ippiDiv can be used.
IppStatus div32f( void ) { Ipp32f a[4*3], b[4*3]; IppiSize roi = {2,2}; int i; for( i=0; i<4*3; ++i ) a[i] = b[i] = (float)i; return ippiDiv_32f_C1IR( a, 4*sizeof(Ipp32f), b, 4*sizeof(Ipp32f), roi ); }
The destination image b contains
-1.#IND +1.000 +2.000 +3.000
+1.000 +1.000 +6.000 +7.000
+8.000 +9.000 +10.00 +11.00Console output:
-- warning in div32f: (6) Zero value(s) of divisor in the function Div