imaqSetCoordinateSystem

NI Vision for LabWindows/CVI Function

imaqSetCoordinateSystem

Usage

int imaqSetCoordinateSystem(Image* image, const CoordinateSystem* system);

Purpose

Sets the coordinate system and scaling constants for the calibrated real-world coordinates of the image.

Image Types Supported

IMAQ_IMAGE_U8, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL

Parameters

Name

Type

Description

image Image* The image whose coordinate system the function sets. This image must already contain calibration information.
system const CoordinateSystem* Defines the coordinate system for the calibrated real-world coordinates.

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

system—Set system to NULL to use the following default coordinate system:

origin {0, 0}
angle 0
axisOrientation IMAQ_INDIRECT