Intel® Integrated Performance Primitives Developer Reference

Developer Reference

  • 2021
  • 03/26/2021
  • Public Content
Contents

DivC

Divides pixel values of an image by a constant.

Syntax

Case 1: Not-in-place operation on one-channel integer or complex data
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
Ipp<datatype>
value
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1RSfs
16u_C1RSfs
16s_C1RSfs
Case 2: Not-in-place operation on multi-channel integer or complex data
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3RSfs
16u_C3RSfs
16s_C3RSfs
16s_AC4RSfs
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
const Ipp<datatype>
value
[4]
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4RSfs
16u_C4RSfs
16s_C4RSfs
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_AC4RSfs
16u_AC4RSfs
Case 3: Not-in-place operation on one-channel floating-point or complex data
IppStatus ippiDivC_32f_C1R
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
Ipp<datatype>
value
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
Case 4: Not-in-place operation on multi-channel floating-point or complex data
IppStatus ippiDivC_32f_C3R
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
IppStatus ippiDivC_32f_C4R
(
const Ipp32f*
pSrc
,
int
srcStep
,
const Ipp32f
value
[4]
,
Ipp32f*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
int
srcStep
,
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
Supported values for
mod
:
32f_AC4R
IppStatus ippiDivC_32f_C4R
(
const Ipp32f*
pSrc
,
int
srcStep
,
const Ipp32f
value
[4]
,
Ipp32f*
pDst
,
int
dstStep
,
IppiSize
roiSize
);
Case 5: In-place operation on one-channel integer or complex data
IppStatus ippiDivC_<mod>
(
Ipp<datatype>
value
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1IRSfs
16u_C1IRSfs
16s_C1IRSfs
Case 6: In-place operation on multi-channel integer or complex data
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3IRSfs
16u_C3IRSfs
16s_C3IRSfs
8u_AC4IRSfs
16u_AC4IRSfs
16s_AC4IRSfs
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value
[4]
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4IRSfs
16u_C4IRSfs
16s_C4IRSfs
Case 7: In-place operation on one-channel floating-point or complex data
IppStatus ippiDivC_<mod>
(
Ipp<datatype>
value
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
);
Supported values for
mod
:
32f_C1IR
Case 8: In-place operation on multi-channel floating-point or complex data
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value
[3]
,
Ipp<datatype>*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
);
Supported values for
mod
:
32f_C3IR
32f_AC4IR
IppStatus ippiDivC_32f_C4IR
(
const Ipp32f
value
[4]
,
Ipp32f*
pSrcDst
,
int
srcDstStep
,
IppiSize
roiSize
);
Case 9: Not-in-place operation on one-channel integer data with platform-aware functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
Ipp<datatype>
value
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1RSfs_L
16u_C1RSfs_L
16s_C1RSfs_L
Case 10: Not-in-place operation on multi-channel integer data with platform-aware functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
const Ipp<datatype>
value[3]
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3RSfs_L
16u_C3RSfs_L
16s_C3RSfs_L
8u_AC4RSfs_L
16u_AC4RSfs_L
16s_AC4RSfs_L
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
const Ipp<datatype>
value[4]
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4RSfs_L
16u_C4RSfs_L
16s_C4RSfs_L
Case 11: Not-in-place operation on one-channel floating point data with platform-aware functions
IppStatus ippiDivC_32f_C1R_L
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
Ipp32f
value
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Case 12: Not-in-place operation on multi-channel floating point data with platform-aware functions
IppStatus ippiDivC_<mod>
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
const Ipp32f
value[3]
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Supported values for
mod
:
32f_C3R_L
32f_AC4R_L
IppStatus ippiDivC_32f_C4R_L
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
const Ipp32f
value[4]
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Case 13: In-place operation on one-channel integer data with platform-aware functions
IppStatus ippiDivC_<mod>
(
Ipp<datatype>
value
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1IRSfs_L
16u_C1IRSfs_L
16s_C1IRSfs_L
Case 14: In-place operation on multi-channel integer data with platform-aware functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value[3]
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3IRSfs_L
16u_C3IRSfs_L
16s_C3IRSfs_L
8u_AC4IRSfs_L
16u_AC4IRSfs_L
16s_AC4IRSfs_L
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value[4]
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4IRSfs_L
16u_C4IRSfs_L
16s_C4IRSfs_L
Case 15: In-place operation on one-channel floating point data with platform-aware functions
IppStatus ippiDivC_32f_C1IR_L
(
Ipp32f
value
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
Case 16: In-place operation on multi-channel integer data with platform-aware functions
IppStatus ippiDivC_<mod>
(
const Ipp32f
value[3]
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
Supported values for
mod
:
32f_C3IR_L
32f_AC4IR_L
IppStatus ippiDivC_32f_C4IR_L
(
const Ipp32f
value[4]
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
Case 17: Not-in-place operation on one-channel integer data with threading layer (TL) functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
Ipp<datatype>
value
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1RSfs_LT
16u_C1RSfs_LT
16s_C1RSfs_LT
Case 18: Not-in-place operation on multi-channel integer data with TL functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
const Ipp<datatype>
value[3]
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3RSfs_LT
16u_C3RSfs_LT
16s_C3RSfs_LT
8u_AC4RSfs_LT
16u_AC4RSfs_LT
16s_AC4RSfs_LT
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>*
pSrc
,
IppSizeL
srcStep
,
const Ipp<datatype>
value[4]
,
Ipp<datatype>*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4RSfs_LT
16u_C4RSfs_LT
16s_C4RSfs_LT
Case 19: Not-in-place operation on one-channel floating point data with TL functions
IppStatus ippiDivC_32f_C1R_LT
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
Ipp32f
value
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Case 20: Not-in-place operation on multi-channel floating point data with TL functions
IppStatus ippiDivC_<mod>
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
const Ipp32f
value[3]
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Supported values for
mod
:
32f_C3R_LT
32f_AC4R_LT
IppStatus ippiDivC_32f_C4R_LT
(
const Ipp32f*
pSrc
,
IppSizeL
srcStep
,
const Ipp32f
value[4]
,
Ipp32f*
pDst
,
IppSizeL
dstStep
,
IppiSizeL
roiSize
);
Case 21: In-place operation on one-channel integer data with TL functions
IppStatus ippiDivC_<mod>
(
Ipp<datatype>
value
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C1IRSfs_LT
16u_C1IRSfs_LT
16s_C1IRSfs_LT
Case 22: In-place operation on multi-channel integer data with TL functions
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value[3]
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C3IRSfs_LT
16u_C3IRSfs_LT
16s_C3IRSfs_LT
8u_AC4IRSfs_LT
16u_AC4IRSfs_LT
16s_AC4IRSfs_LT
IppStatus ippiDivC_<mod>
(
const Ipp<datatype>
value[4]
,
Ipp<datatype>*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
,
int
scaleFactor
);
Supported values for
mod
:
8u_C4IRSfs_LT
16u_C4IRSfs_LT
16s_C4IRSfs_LT
Case 23: In-place operation on one-channel floating point data with TL functions
IppStatus ippiDivC_32f_C1IR_LT
(
Ipp32f
value
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
Case 24: In-place operation on multi-channel integer data with TL functions
IppStatus ippiDivC_<mod>
(
const Ipp32f
value[3]
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
Supported values for
mod
:
32f_C3IR_LT
32f_AC4IR_LT
IppStatus ippiDivC_32f_C4IR_LT
(
const Ipp32f
value[4]
,
Ipp32f*
pSrcDst
,
IppSizeL
srcDstStep
,
IppiSizeL
roiSize
);
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
Pointer to the source image ROI.
srcStep
Distance in bytes between starts of consecutive lines in the source image.
value
The constant value to divide each pixel value in a source buffer (constant vector in case of 3- or four-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 for the in-place operation.
roiSize
Size of the source and destination ROI in pixels.
scaleFactor
Scale factor (see InInteger Result Scaling).
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function changes image intensity by dividing pixel values of an image buffer by the constant
value
. For multi-channel images, pixel channel values are divided by the components of a constant vector
value
. 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 divisor value is zero, the function execution is aborted and the
ippStsDivByZeroErr
 error status is set. Note that in the alpha channel case (
AC4
), the alpha channels are not processed.
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
srcStep
,
dstStep
, or
srcDstStep
 has a zero or negative value.
ippStsDivByZeroErr
Indicates an error condition if the divisor value is zero.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.