imaqGetContourInfo

Usage

ContourInfo* imaqGetContourInfo(const ROI* roi, ContourID id);

Purpose

Returns information about a particular contour. The structure that the function returns contains a copy of the data from the contour. Modifications to the information in the structure do not affect the contour.

Note  This function is obsolete. The replacement function is imaqGetContourInfo2(), which returns a new structure called ContourInfo2. This new structure accounts for the two new contour types—the annulus and the rotated rectangle. Using imaqGetContourInfo to get information about one of the new contour types returns misleading information.

Parameters

Name	Type	Description
roi	const ROI*	The region of interest (ROI) containing the contour from which the function gets the information.
id	ContourID	The ContourID of the contour about which the function gets information.

Return Value

Type	Description
ContourInfo*	On success, this function returns a pointer to the structure containing information about the requested contour. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with this structure, dispose of the pointer by calling imaqDispose().