imaqThreshold

Usage

int imaqThreshold(Image* dest, const Image* source, float rangeMin, float rangeMax, int useNewValue, float newValue);

Purpose

Thresholds an image. The function sets pixels values outside of the given range to 0. The function sets pixel values within the range to a given value or leaves the values unchanged.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL

Parameters

Name	Type	Description
dest	Image*	The destination image.
source	const Image*	The source image.
rangeMin	float	The lower boundary of the range of pixel values to keep.
rangeMax	float	The upper boundary of the range of pixel values to keep.
useNewValue	int	Set this parameter to TRUE to set the pixel values within [rangeMin, rangeMax] to the value specified in newValue. Set this field to FALSE to leave the pixel values unchanged.
newValue	float	If you set useNewValue to TRUE, newValue is the replacement value for pixels within the range. If you set useNewValue to FALSE, the function ignores this parameter.

Return Value

Type	Description
int	On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().