TransformImage
TransformImage generates an Image data structure that accounts for the distortion present in a CalibrateGrid function. For more information, see CalibrateGrid.
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.
TransformImage Inputs
Syntax: TransformImage(Image,Calibration,Region,Image Scale,Origin,Show)
Parameter | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
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. |
|||||||||
This argument must reference a spreadsheet cell that contains a valid Calib data structure created by a CalibrateGrid function. |
|||||||||
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.
|
|||||||||
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. |
|||||||||
Specifies the origin reference point for the transformation.
|
|||||||||
Specifies the display mode for TransformImage graphics on the image.
|
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.