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