CogCalibCheckerboard Calibrate Method Cognex VisionPro 9.5
Computes the mapping to calibrated space using the current CalibrationImage and related parameters. If successful, sets the Calibrated property to True, updates the computed transforms, and makes this object ready to run via the Execute method.

Namespace: Cognex.VisionPro.CalibFix
Assembly: Cognex.VisionPro.CalibFix (in Cognex.VisionPro.CalibFix.dll) Version: 69.0.0.0
Syntax

public void Calibrate()
Events

Event TypeReason
CogCalibCheckerboard Changed

Fires when calibration is completed successfully. This event may also fire if calibration fails depending upon which calibration steps were completed prior to this call to this method. Calibration StepState Flags AffectedStep 1

Step 2 and higherStep 3 and higher with nonlinear warping

Exceptions

ExceptionCondition
CogCalibFixTooFewVerticesExceptionFewer than nine tile vertices were found.
CogImageBadTypeExceptionCalibrationImage is neither a CogImage8Grey, nor a CogImage16Grey.
CogCalibFixNoFiducialExceptionA fiducial mark was expected but not found.
CogCalibFixCheckerboardMathUnstableExceptionThe object cannot be calibrated because the located tile vertices yield a numerically unstable result. Verify that you have supplied a well-focused high-contrast image of the calibration plate. Use the diagnostic graphics to make sure that the tile vertices have been located correctly, and make sure that you have specified correct values for the tile size.
CogSecurityViolationExceptionSecurity is not enabled for this vision tool. See Resolving Security Related Error Messages for more information.
CogCalibFixNoCalibrationImageExceptionCalibrationImage is NULL.
CogCalibFixBadDestRectExceptionThe WarpDestinationRectangle does not intersect any filled pixels of the undistorted image.
CogCalibFixDataMatrixDecodeErrorExceptionA DataMatrix fiducial was expected, but no DataMatrix code that was successfully found could be successfully decoded.
CogCalibFixDataMatrixNotFoundExceptionA DataMatrix fiducial was expected but not found.
CogCalibFixDataMatrixParseErrorExceptionA DataMatrix fiducial was expected, but no DataMatrix code thas was successfully decoded could be successfully parsed.
CogImageNoPixelsExceptionCalibrationImage is not allocated.
Remarks

Computes the mapping to calibrated space using the current CalibrationImage and related parameters. If successful, sets the Calibrated property to True, updates the computed transforms, and makes this object ready to run via the Execute(ICogImage, CogCalibCheckerboardRunParams) method.

See Also