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.
CalibrateImage Inputs
Syntax: CalibrateImage(Image,Calibration)
Parameter | Description |
---|---|
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. |
|
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.
|