Rectify Image

Use this tool to rectify images, i.e., to transform the image in order to correct the effects of possible lens distortions, rotations, or tilted camera. The "Calibration Data" must be determined previously with the tool Calibrate Camera.

The "Calibration Data" can also be applied directly in the tools for further image processing, e.g., measuring. In this case the image does not need to be rectified first. Thus, using this tool leads to an increased processing time.

Parameters

Basic Parameters

Image:

This parameter represents the image which should be rectified.

If a color image is used as an input image, all channels of the color image are used for the processing.

Calibration Data:

This parameter defines the calibration data needed for the correction of possible lens distortions and the position of the camera with respect to the image plane. To rectify the image according to the desired calibration data, you have to connect the parameter to the respective result of Calibrate Camera, to make sure that calibration data are transmitted to this tool. They will be instantly applied to the image.

Results

Basic Results

Rectified Image:

This results contains the image that has been rectified with the "Calibration Data".

Pixel Size:

This result contains the corresponding "Pixel Size" in case it was included in the "Calibration Data" so it can be used by following tools. The result is returned as real number.

Tool State:

"Tool State" returns information about the state of the tool and thus can be used for error handling. For more information, see Tool State Result

Additional Results

Adapted Calibration Data:

This result contains the "Adapted Calibration Data" which can be used for the "Rectified Image" for further image processing.

X Axis:

This result returns the x-axis of the rectified coordinate system. The result is returned as a contour and visualized in red.

Y Axis:

This result returns the y-axis of the rectified coordinate system. The result is returned as a contour and visualized in green.

Processing Time:

This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.

Application Examples

This tool is used in the following MERLIC Vision App examples:

• calibrate_for_ruler_distorted.mvapp