imaqGetContourInfo

NI Vision for LabWindows/CVI Function

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