imaqCorrectCalibratedImage
Usage
int imaqCorrectCalibratedImage(Image* dest, const Image* source, PixelValue fill, InterpolationMethod method, const ROI* roi);
Purpose
Spatially corrects an image by applying the calibration information associated with the 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_I16, IMAQ_IMAGE_SGL, IMAQ_IMAGE_RGB, IMAQ_IMAGE_HSL
Parameters
|
Name
|
Type
|
Description
|
|---|---|---|
| dest | Image* | The destination image. |
| source | const Image* | The calibrated image that the function corrects. |
| fill | PixelValue | The value that the function fills pixels in a corrected image with. These pixels were not part of the original image. |
| method | InterpolationMethod | The method of interpolation. The valid interpolation methods for correction are IMAQ_ZERO_ORDER and IMAQ_BILINEAR. |
| roi | const ROI* | Specifies the region of the image the function corrects. Set this parameter to NULL to correct the whole 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(). |