Div

Syntax

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

The function ippiDiv is declared in the ippi.h file. It 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 channelss.

Example “Division of Pixel Values” illustrates how the function ippiDiv can be used.

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.

Division of Pixel Values

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.00
Console output:

-- warning in div32f: (6) Zero value(s) of divisor in the function Div