Calibrate Image Controls

NI Vision Builder

Process Images Tab

Calibrate Image Controls

Main Tab

The following controls are available on the Main tab.

Control Name Description
Step Name Name to give the step.
Calibration Type Type of calibration you selected in the calibration wizard, either Simple Calibration, Calibration Using User-Defined Points, Grid Calibration, or Calibration from Image.
Calibrated Image File Path Path to the calibrated image whose calibration information you use to set the calibration information of the current image.
New Calibration Launches the calibration wizard so you can create a new calibration setup.
Edit Calibration Loads the calibration wizard so you can change your calibration setup.
Relearn Calibration at Each Iteration When enabled, the step relearns the calibration information at each iteration of the inspection.
Save Calibrated Image to File When enabled, the step saves the calibrated image to the path specified in the New Calibrated Image File Path control.
New Calibrated Image File Path File path to which you want to save the image calibrated by this step.

Calibration Tab

The following information is available on the Calibration tab.

Note  The contents of the Calibration tab vary depending on the Calibration Type selected in the Calibration Wizard.

Simple Calibration

Control Name Description
Pixel Type Indicates whether the image has square or nonsquare pixels.
Correspondence Image - Real World Gives the real-world size of a pixel in both the horizontal (x) and vertical (y) directions.

User Points Calibration


Control Name Description
Calibration Points Lists the points selected for calibration in the calibration wizard.
Image Coordinates Coordinates of the currently selected calibration point, given as the number of pixels from the origin.
Real-World Coordinates Coordinates of the currently selected calibration point, given as the number of Units from the origin.
Unit Unit of measure selected in the calibration wizard.
Distortion Type of distortion selected in the calibration wizard, either Perspective or Nonlinear.

Grid Calibration


Control Name Description
Pixel Type Indicates whether your image has square or nonsquare pixels.
Correspondence Image - Real World Coordinates of the currently selected calibration point, given as the number of Units from the origin.
Unit Unit of measure you selected in the calibration wizard.
Distortion Type of distortion you selected in the calibration wizard, either Perspective or Nonlinear.

Calibration from Image


Control Name Description
Pixel Type Indicates whether your image has square or nonsquare pixels.
Correspondence Image - Real World Gives the real-world size of a pixel in both the horizontal (x) and vertical (y) directions.

Axis Tab

The following controls are available on the Axis tab.

Control Name Description
Axis Origin X- and y-coordinates of the origin you selected in the calibration wizard.
Axis Reference Direction of the y-axis, either Direct or Indirect.
Angle Relative to Horizontal Angle of the x-axis of the calibration axis you selected relative to horizontal.
Correct Image When enabled, the step corrects the calibrated image by applying a calibration to create a spatially correct image.
Interpolation Type Specifies the interpolation method to use to obtain the corrected image. The following options are valid:
  • Zero Order (default)—Rounds to the nearest integral pixel location.
  • Bi-Linear—Uses linear interpolation in both the x- and y-directions to compute the pixel location.
Replace Value Specifies the value that the step uses to fill pixels in the corrected image that the step could not correct in the original image. The default is 0.