imaqTransformRealWorldToPixel
Usage
TransformReport* imaqTransformRealWorldToPixel(const Image* image, const PointFloat* realWorldCoordinates, int numCoordinates);
Purpose
Transforms real-world coordinates to pixel coordinates, according to the calibration information contained in an image.
 |
Note You must first attach calibration information to this image by using one of the following functions: imaqCopyCalibrationInfo2() imaqLearnCalibrationGrid() imaqLearnCalibrationPoints() imaqSetSimpleCalibration() |
Image Types Supported
IMAQ_IMAGE_U8, IMAQ_IMAGE_U16, IMAQ_IMAGE_I16, IMAQ_IMAGE_SGL, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| image | const Image* | The image whose calibration information the function uses to transform the real-world coordinates. |
| realWorldCoordinates | const PointFloat* | The array of real-world coordinates the function transforms to pixel coordinate. This parameter is required and cannot be NULL. |
| numCoordinates | int | The number of coordinates in the array. |
Return Value
| Type |
Description |
|---|---|
| TransformReport* | On success, this function returns a report describing the pixel coordinates. On failure, this function returns NULL. To get extended error information, call imaqGetLastError(). When you are finished with the report, dispose of it by calling imaqDispose(). |