CalibrateImage

CalibrateImage associates a Calib data structure with an Image data structure, to create a new Image data structure. The resulting data structure can be referenced by other vision tool functions, in order to display their results in the world coordinates defined by the referenced calibration.

For example, a sensor is calibrated using a Coordinate Transforms function, such as CalibrateGrid. Next, a CalibrateImage function is inserted, with the Calib parameter set as a cell reference to the recently created Calib structure of the CalibrateGrid function. Then, another vision tool, such as ExtractBlobs, sets its Image parameter as a cell reference to the CalibrateImage data structure, causing the ExtractBlobs coordinate results in the world coordinates of the calibrated image.

Note: The output of any vision tool that reports in real-world coordinates cannot be used as a fixture or region input to another vision tool.

CalibrateImage Inputs

Syntax: CalibrateImage(Image,Calibration)

Parameter	Description
Image	This argument must reference a spreadsheet cell that contains a valid Image data structure. By default, the cell referenced is A0, the cell containing the data structure returned by AcquireImage.
Calib	This argument must reference a spreadsheet cell that contains a valid Calib data structure.

CalibrateImage Outputs

Returns

An Image data structure containing the processed image, or #ERR if any of the input parameters are invalid.

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