imaqBuildCoordinateSystem
Usage
int imaqBuildCoordinateSystem(const Point* points, ReferenceMode mode, AxisOrientation orientation, CoordinateSystem* system);
Purpose
Builds a reference for any arbitrary coordinate system with respect to the image plane. The reference of the coordinate system is specified as the position of the origin of the coordinate system, the orientation of its x-axis with respect to that of the image plane, and the direction of the y-axis, as shown in the following illustration.
![](analytic_geometry_1.gif)
Parameters
Name
|
Type
|
Description
|
---|---|---|
points | const Point* | An array of points defining the coordinate system. If mode is IMAQ_COORD_X_Y, the points array must have three points. If mode is IMAQ_COORD_ORIGIN_X, the points array must have two points. |
mode | ReferenceMode | Specifies the method that the function uses to calculate the coordinate system. |
orientation | AxisOrientation | The direction of the y-axis of a coordinate system. |
system | CoordinateSystem* | On return, contains the coordinate system defined by the point array. 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(). |