imaqMultithreshold

Usage

int imaqMultithreshold(Image* dest, const Image* source, const ThresholdData* ranges, int numRanges);

Purpose

Thresholds an image into multiple classes. The function classifies each pixel into the first threshold range of which it is a member. If a pixel is not a member of any of the given ranges, the function sets it to 0. For example, given two threshold ranges:

rangeMin	rangeMax	useNewValue	newValue
80	150	TRUE	10
120	200	FALSE	ignored

The function operates as follows:

• The function replaces pixel values below 80 with 0.
• The function replaces pixel values from 80 to 150 with 10.
• The function does not change pixel values from 151 to 200.
• The function replaces pixel values above 200 with 0.

For more information about thresholding, refer to imaqThreshold().

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.
ranges	const ThresholdData*	An array of threshold ranges. This array is required and cannot be NULL.
numRanges	int	The number of elements in the ranges array.

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().