imaqCorrectCalibratedImage

NI Vision for LabWindows/CVI Function

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