imaqTransformROI2

NI Vision for LabWindows/CVI Function

imaqTransformROI2

Usage

int imaqTransformROI2(ROI* roi, const CoordinateSystem* baseSystem, const CoordinateSystem* newSystem);

Purpose

Rotates and translates a region of interest (ROI) from one coordinate system to another coordinate system within an image.

Parameters

Name

Type

Description

roi ROI* The ROI to transform. This parameter is required and cannot be NULL.
baseSystem const CoordinateSystem* Describes the base coordinate system. This parameter is required and cannot be NULL.
newSystem const CoordinateSystem* Describes the new coordinate system. This parameter is required and cannot be NULL.

Return Value

Type

Description

int On success, this function returns a non-zero value. On failure, this function returns 0. To get extended error information, call imaqGetLastError().

Parameter Discussion

roi—If necessary, the function converts rectangle contours inside roi to rotated rectangle contours. If necessary, the function converts oval contours inside roi to closed contours.