Visible to Intel only — GUID: GUID-EBA7E3A0-8900-471D-BAEA-AF2393183B16
Visible to Intel only — GUID: GUID-EBA7E3A0-8900-471D-BAEA-AF2393183B16
Div_Round
Divides pixel values of an image by pixel values of another image with different rounding modes.
Syntax
Case 1: Not-in-place operation on integer data
IppStatus ippiDiv_Round_<mod>(const Ipp<datatype>* pSrc1, int src1Step, const Ipp<datatype>* pSrc2, int src2Step, Ipp<datatype>* pDst, int dstStep, IppiSize roiSize, IppRoundMode rndMode, 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: In-place operation on integer data
IppStatus ippiDiv_Round_<mod>(const Ipp<datatype>* pSrc, int srcStep, Ipp<datatype>* pSrcDst, int srcDstStep, IppiSize roiSize, IppRoundMode rndMode, 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 |
Include Files
ippi.h
Domain Dependencies
Headers: ippcore.h, ippvm.h, ipps.h
Libraries: ippcore.lib, ippvm.lib, ipps.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. |
||||||
roundMode |
Rounding mode, the following values are possible:
|
||||||
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. The resulting values are scaled by scaleFactor and rounded using the rounding method specified by the parameter roundMode. 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 channelss.
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. |
ippStsStsRoundModeNotSupportedErr |
Indicates an error condition if the roundMode has an illegal value. |