imaqAutoThreshold2

Usage

ThresholdData* imaqAutoThreshold2(Image* dest, const Image* source, int numClasses, ThresholdMethod method, const Image* mask);

Purpose

Automatically thresholds an image into multiple classes.

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 image to threshold.
numClasses	int	The number of classes into which to threshold the image. Valid values range from 2 to 256.
method	ThresholdMethod	The method for binary thresholding. If numClasses is 2 (a binary threshold), method specifies how to calculate the classes. If numClasses is not 2, the function ignores this parameter.
mask	const Image*	An optional mask image. This image must be an IMAQ_IMAGE_U8 image. When calculating the auto threshold, the function considers only those pixels in image whose corresponding pixels in mask are non-zero. Set this parameter to NULL if you want the function to perform an auto threshold on the whole image.

Return Value

Type	Description
ThresholdData*	On success, this function returns an array of structures providing information about the threshold ranges that the function applied. The array contains a number of ThresholdData structures equal to numClasses. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the array, dispose of it by calling imaqDispose().