imaqAddClosedContour

NI Vision for LabWindows/CVI Function

imaqAddClosedContour

Usage

ContourID imaqAddClosedContour(ROI* roi, const Point* points, int numPoints);

Purpose

Creates a new ROI contour based on the provided array of points. To make the contour, the function connects each point in the array to the next point in the array and connects the last point in the array to the first point in the array. The function adds the contour to the provided ROI.

Parameters

Name

Type

Description

roi ROI* The ROI to contain the new contour.
points const Point* An array of points describing the location and shape of the contour. This parameter is required and cannot be NULL.
numPoints int The number of points in the array.

Return Value

Type

Description

ContourID On success, this function returns a ContourID for the added contour. You can use the ContourID to reference the contour within the containing ROI. On failure, this function returns 0. To get extended error information, call imaqGetLastError().