imaqAddOpenContour

NI Vision for LabWindows/CVI Function

imaqAddOpenContour

Usage

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

Purpose

Creates a new region of interest (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. The function does not connect 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 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().