imaqAutoThreshold

Usage

ThresholdData* imaqAutoThreshold(Image* dest, Image* source, int numClasses, ThresholdMethod method);

Purpose

Automatically thresholds an image into multiple classes.

Note  This function is obsolete. The replacement function is imaqAutoThreshold2(), which incorporates the functionality of imaqAutoThreshold() but has a mask parameter that enables you to control which pixels the function thresholds.

Image Types Supported

IMAQ_IMAGE_U8

Parameters

Name	Type	Description
dest	Image*	The destination image.
source	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.

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