Developer Reference

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

CompareEqualEpsC

Tests whether floating-point pixel values of an image are equal to a given value within a certain tolerance
eps
.

Syntax

Case 1: Operation on one-channel data
IppStatus ippiCompareEqualEpsC_32f_C1R
(
const Ipp32f*
pSrc
,
int
srcStep
,
Ipp32f
value
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
eps
);
Case 2: Operation on multi-channel data
IppStatus ippiCompareEqualEpsC_32f_C3R
(
const Ipp32f*
pSrc
,
int
srcStep
,
const Ipp32f
value
[3]
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
eps
);
IppStatus ippiCompareEqualEpsC_32f_C4R
(
const Ipp32f*
pSrc
,
int
srcStep
,
const Ipp32f
value
[4]
,
Ipp8u*
pDst
,
int
dstStep
,
IppiSize
roiSize
,
Ipp32f
eps
);
IppStatus ippiCompareEqualEpsC_32f_AC4R
(
const Ipp32f*
pSrc
,
int
srcStep
,
const Ipp32f
value
[3]
,
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
pSrc
Pointer to the source image ROI.
srcStep
Distance in bytes between starts of consecutive lines in the source image.
value
The value to compare each pixel to. In case of multi-channel data, an array of separate values (one for each channel).
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 pixel values of the source image ROI
pSrc
are equal to a given constant
value
within the tolerance
eps
, and writes the results to a one-channel
Ipp8u
image
pDst
. If the absolute value of difference between the pixel value in
pSrc
and
value
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 between all color channel values of a pixel and the respective components of
value
must be within the tolerance
eps
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 a zero or negative value.
ippStsStepErr
Indicates an error condition if
srcStep
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