Developer Reference

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

CountInRange

Computes the number of pixels within the given intensity range.

Syntax

Case 1: Operation on one-channel data
IppStatus ippiCountInRange_<mod>(const Ipp<datatype>*
pSrc
, int
srcStep
, IppiSize
roiSize
, int*
counts
, Ipp<datatype>
lowerBound
, Ipp<datatype>
upperBound
);
Supported values for
mod
:
8u_C1R
32f_C1R
Case 2: Operation on multi-channel data
IppStatus ippiCountInRange_<mod>(const Ipp<datatype>*
pSrc
, int
srcStep
, IppiSize
roiSize
, int
counts[3]
, Ipp<datatype>
lowerBound[3]
, Ipp<datatype>
upperBound[3]
);
Supported values for
mod
:
8u_C3R
32f_C3R
8u_AC4R
32f_AC4R
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.
roiSize
Size of the source ROI in pixels.
counts
The computed number of pixels within the given intensity range. An array of 3 values in case of multi-channel data.
lowerBound
Lower limit of the intensity range.
upperBound
Upper limit of the intensity range.
Description
This function operates with ROI (see Regions of Interest in Intel IPP). This function computes the number of pixels in the image which have intensity values in the range between
lowerBound
and
upperBound
(inclusive).
In case of a multi-channel image, pixels are counted within intensity range for each color channel separately, and the array
counts
of three resulting values is returned. The alpha channel values, if present, are not processed.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or a warning.
ippStsNullPtrErr
Indicates an error condition if
pSrc
pointer is
NULL
.
ippStsSizeErr
Indicates an error condition if
roiSize
has a field with zero or negative value.
ippStsStepErr
Indicates an error condition if
srcStep
has a zero or negative value.
ippStsRangeErr
Indicates an error condition if
lowerBound
exceeds
upperBound
.

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