Specifications
Histogram, Threshold, and Compare Functions
10-23
10
EqualSFPEps
Tests if the pixel values are
equal to a floating-point scalar
value within a tolerance ε.
IPLStatus iplEqualSFPEps (IplImage*
src
, float
s
,
IplImage*
dst
, float
eps
);
src
Thesourceimage.
s
The 32-bit floating-point scalar value to be
compared with pixel values.
dst
The resultant 1-bit image.
eps
The tolerance ε.
Discussion
The function iplEqualSFPEps() tests if pixels of the input image
src
are
equal to a scalar value
s
within the tolerance
eps
, and writes the results to
a 1-bit image
dst
. If the absolute value of difference of the input pixel
value and
s
is less than
eps
, then the corresponding pixel in
dst
is set to 1;
otherwise the pixel in
dst
is set to 0.
The function supports only images with 32-bit floating-point pixel data.
If the source image COI is not set, a pixel is considered to be “equal” to
s
only if each channel in the pixel is equal to
s
within the given tolerance. If
the COI is set, the function compares
s
and the pixel values in the COI.
The function returns
IPL_StsOK if the compare operation is successful.
If you pass an image with data of an unsupported type or a null pointer, the
function does not perform the compare operation and returns an error status
code.