TransformImage

TransformImage generates an Image data structure that accounts for the distortion present in a CalibrateGrid function. For more information, see CalibrateGrid.

Note: This function only outputs greyscale images.

TransformImage Overview

TransformImage generates an Image data structure, using a CalibrateGrid Calib data structure and the Image data structure being referenced by the CalibrateGrid function as arguments, that accounts for linear, non-linear and lens distortion to return an "undistorted" version of the image being used by the CalibrateGrid function. This new output image is based in pixels, but simultaneously, an ExtractCalibration function is automatically inserted into the spreadsheet, which creates a 2D transformation, in real-world coordinates, based upon the calibration of the TransformImage function. For more information, see ExtractCalibration.

Note: The TransformImage training period, which takes place when the function is added to the spreadsheet, when the specified region is changed or when a job with the function is loaded, may take as long as 3 seconds on a sensor with a 640x480 resolution, and as long as 30 seconds on a sensor with a 1600x1200 resolution.

TransformImage Inputs

Syntax: TransformImage(Image,Calibration,Region,Image Scale,Origin,Show)

Parameter

Description

Image

This parameter must reference a spreadsheet cell that contains an Image data structure. By default, this parameter references A0, the cell containing the AcquireImage Image data structure. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image functions. For more information, see AcquireImage and Image.

Calibration

This argument must reference a spreadsheet cell that contains a valid Calib data structure created by a CalibrateGrid function.

Region

Also known as the Region of Interest (ROI), specifies the region of the image that undergoes image analysis; creates a rectangular image region that can be re-shaped. With this parameter selected, by pressing the Maximize Region button on the property sheet's toolbar, the region will automatically be stretched to cover the entire image.

X	The x-offset of the origin, in fixture coordinates..
Y	The y-offset of the origin, in fixture coordinates.
High	The dimension along the region's x-axis.
Wide	The dimension along the region's y-axis.

Image Scale

Specifies the scale at which the transformed image is displayed. The minimum setting is 0.01, the maximum is 10.00 and the default setting is 1.0.

Reference Point

Specifies the origin reference point for the transformation.

0 = Image Center (default)	The reference point will be the center of the image.
1 = Region Center	The reference point will be the center of the ROI.

Show

Specifies the display mode for TransformImage graphics on the image.

0 = hide all	All graphics will be hidden, except when the cell containing the TransformImage function is highlighted in the spreadsheet.
1 = result graphics only	The undistorted image will be displayed at all times.
2 = input and result graphics	The input image region and undistorted image will be displayed at all times.

TransformImage Outputs

Returns

An Image data structure containing the processed image, or #ERR if any of the input parameters are invalid. Also automatically inserts an ExtractCalibration Calib data structure, which creates a 2D transformation, in real-world coordinates, based on the Image data structure returned by TransformImage.

Note: The contents of the processed image region in the Image data structure are not saved with the job.

For more information, see Property Sheet or Calibrate Functions.