Developer Reference

  • 2020
  • 10/21/2020
  • Public Content
Contents

CompareEqualEps

Compares two images with floating-point data, testing whether pixel values are equal within a certain tolerance
eps
.

Syntax

IppStatus ippiCompareEqualEps_
<mod>
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
eps
);
Supported values for
mod
:
32f_C1R
32f_C3R
32f_C4R
IppStatus ippiCompareEqualEps_32f_AC4R
(
const Ipp32f*
pSrc1
,
int
src1Step
,
const Ipp32f*
pSrc2
,
int
src2Step
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
eps
);
Include Files
ippi.h
Domain Dependencies
Headers:
ippcore.h
,
ippvm.h
,
ipps.h
Libraries:
ippcore.lib
,
ippvm.lib
,
ipps.lib
Parameters
pSrc1
,
pSrc2
Pointers to the source image ROIs.
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.
roiSize
Size of the source and destination ROI in pixels.
eps
The tolerance value.
Description
This function operates with ROI (see Regions of Interest in Intel IPP).
This function tests if the corresponding pixels of ROI in two source images
pSrc1
,
pSrc2
are equal within the tolerance
eps
, and writes the results to a one-channel
Ipp8u
image
pDst
. If the absolute value of difference of the pixel values in
pSrc1
and
pSrc2
is less than or equal to
eps
, then the corresponding pixel in
pDst
is set to an
IPP_MAX_8U
value; otherwise the pixel in
pDst
is set to 0. For multi-channel images, the differences for all color channel values of a pixel must be within the
eps
tolerance for the compare condition to be true.
This function processes images with floating-point data only.
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 pointer is
NULL
.
ippStsSizeErr
Indicates an error condition if
roiSize
has a field with zero or negative value.
ippStsStepErr
Indicates an error condition if
src1Step
,
src2Step
, or
dstStep
has a zero or negative value.
ippStsEpsValErr
Indicates an error condition if
eps
has a 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