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

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

The function ippiCountInRange is declared in the ippi.h file. It 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.