imaqTransformROI

Usage

int imaqTransformROI(ROI* roi, Point originStart, float angleStart, Point originFinal, float angleFinal);

Purpose

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

Note  This function is obsolete. The replacement function is imaqTransformROI2(). The new function uses a new structure called a CoordinateSystem. A CoordinateSystem accounts for the direction of the y-axis, for which imaqTransformROI() does not take into account. In addition, a CoordinateSystem uses a PointFloat to represent the origin, which allows for increased accuracy.

Parameters

Name	Type	Description
roi	ROI*	The ROI to transform.
originStart	Point	The origin of the starting coordinate system.
angleStart	float	The angle, in degrees, of the x-axis of the starting coordinate system relative to the x-axis of the image.
originFinal	Point	The origin of the new coordinate system.
angleFinal	float	The angle, in degrees, of the x-axis of the new coordinate system relative to the x-axis of the image.

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