Developer Reference

  • 2020
  • 07/15/2020
  • Public Content
Contents

DotProd

Computes the dot product of pixel values of two source images.

Syntax

Case 1: Operation on one-channel integer data
IppStatus ippiDotProd_<mod>
(
const Ipp<srcDatatype>*
pSrc1
,
int
src1Step
,
const Ipp<srcDatatype>*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f*
pDp
);
Supported values for
mod
:
8u64f_C1R
16u64f_C1R
16s64f_C1R
32u64f_C1R
32s64f_C1R
Case 2: Operation on three-channel integer data
IppStatus ippiDotProd_<mod>
(
const Ipp<srcDatatype>*
pSrc1
,
int
src1Step
,
const Ipp<srcDatatype>*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[3]
);
Supported values for
mod
:
8u64f_C3R
16u64f_C3R
16s64f_C3R
32u64f_C3R
32s64f_C3R
Case 3: Operation on four-channel integer data
IppStatus ippiDotProd_<mod>
(
const Ipp<srcDatatype>*
pSrc1
,
int
src1Step
,
const Ipp<srcDatatype>*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[4]
);
Supported values for
mod
:
8u64f_C4R
16u64f_C4R
16s64f_C4R
32u64f_C4R
32s64f_C4R
IppStatus ippiDotProd_<mod>
(
const Ipp<srcDatatype>*
pSrc1
,
int
src1Step
,
const Ipp<srcDatatype>*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[3]
);
Supported values for
mod
:
8u64f_AC4R
16u64f_AC4R
32u64f_AC4R
16s64f_AC4R
32s64f_AC4R
Case 4: Operation on floating-point data
IppStatus ippiDotProd_32f64f_C1R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f*
pDp
,
IppHintAlgorithm
hint
);
IppStatus ippiDotProd_32f64f_C3R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[3]
,
IppHintAlgorithm
hint
);
IppStatus ippiDotProd_32f64f_C4R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[4]
,
IppHintAlgorithm
hint
);
IppStatus ippiDotProd_32f64f_AC4R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
IppiSize
roiSize
,
Ipp64f
pDp
[3]
,
IppHintAlgorithm
hint
);
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
pSrc1
,
pSrc2
Pointer to the ROI in the source images.
src1Step
,
src2Step
Distance, in bytes, between the starting points of consecutive lines in the source images.
roiSize
Size of the source image ROI.
pDp
Pointer to the dot product or to the array containing the computed dot products for multi-channel images.
hint
Option to select the algorithmic implementation of the function, see Table “ Hint Arguments for Image Moment Functions ”.
Description
This function operates with ROI (see Regions of Interest in Intel IPP ).
This function computes the dot product of pixel values of two source images
pSrc1
and
pSrc2
using algorithm indicated by the hint argument (see Table “ Hint Arguments for Image Moment Functions ”) and stores the result in
pDp
. In case of multi-channel images, the dot product is computed for each channel separately and stored in the array
pDp
.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error.
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 one of the step values has zero or negative value.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804