CogCalibCheckerboard.FiducialMark Property

CogCalibCheckerboard FiducialMark Property

Cognex VisionPro

An enumeration that specifies what style of fiducial mark is present on the calibration plate.

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

Syntax

C++

Copy to Clipboard Print

public CogCalibCheckerboardFiducialConstants FiducialMark { get; set; }

public CogCalibCheckerboardFiducialConstants FiducialMark { get; set; }

Public Property FiducialMark As CogCalibCheckerboardFiducialConstants 
	Get 
	Set

Public Property FiducialMark As CogCalibCheckerboardFiducialConstants 
	Get 
	Set

public:
property CogCalibCheckerboardFiducialConstants FiducialMark {
	CogCalibCheckerboardFiducialConstants get ();
	void set (CogCalibCheckerboardFiducialConstants value);
}

public:
property CogCalibCheckerboardFiducialConstants FiducialMark {
	CogCalibCheckerboardFiducialConstants get ();
	void set (CogCalibCheckerboardFiducialConstants value);
}

Property Value

Type: CogCalibCheckerboardFiducialConstants

Events

Event Type	Reason
CogCalibCheckerboard Changed	Fires when the value of this property changes. The following state flag may be affected: SfFiducialMark
CogCalibCheckerboard Changed	Fires when the value of this property changes and full or partial calibration is completed. The actual state flags affected depend on which calibration steps were completed. Calibration StepState Flags AffectedStep 1 SfNumPoints SfGetUncalibratedPointX SfGetUncalibratedPointY SfGetRawCalibratedPointX SfGetRawCalibratedPointY Step 2 and higher SfCalibrated SfGetComputedUncalibratedFromCalibratedTransform SfGetComputedUncalibratedFromRawCalibratedTransform SfComputedRMSError SfGetInfoStrings Step 3 and higher SfGetOutputImageRootFromCalibratedTransform (step 5 and higher with nonlinear warping) SfOutputImageMask (step 5 and higher with nonlinear warping) SfUndistortedCalibrationImage (step 5 and higher with nonlinear warping) SfUndistortedCalibrationImageMask (step 5 and higher with nonlinear warping)

Event Type

Reason

CogCalibCheckerboard Changed

Fires when the value of this property changes.

The following state flag may be affected:

SfFiducialMark

CogCalibCheckerboard Changed

Fires when the value of this property changes and full or partial calibration is completed. The actual state flags affected depend on which calibration steps were completed. Calibration StepState Flags AffectedStep 1

Step 2 and higher

Step 3 and higher

SfGetOutputImageRootFromCalibratedTransform (step 5 and higher with nonlinear warping)
SfOutputImageMask (step 5 and higher with nonlinear warping)
SfUndistortedCalibrationImage (step 5 and higher with nonlinear warping)
SfUndistortedCalibrationImageMask (step 5 and higher with nonlinear warping)

Exceptions

Exception	Condition
ArgmentException	The fiducial mark type is not in CogCalibCheckerboardFiducialConstants.

Remarks

This property specifies whether or not a fiducial mark is present on the calibration plate. The tool uses this information to establish the origin and handedness of the raw calibrated space defined by the calibration plate.

If you specify None, the tool will use the vertex closest to the center of the calibration image as the origin and will assign the positive x-axis and y-axis to the grid lines which are closest to the image's x-axis and y-axis. If you specfiy StandardRectangles, the tool will attempt to locate a Cognex-standard fiducial mark for a checkerboard calibration plate. If you specify DotGridAxes, the tool will attempt to locate a Cognex-standard fiducial mark for a grid-of-dots calibration plate. If you specify DataMatrix, the tool will attempt to locate a DataMatrix style fiducial mark for a checkerboard calibration plate. If you specify DataMatrixWithGridPitch, the tool will attempt to locate a DataMatrix style fiducial mark for a checkerboard calibration plate and will attempt to parse the grid pitch from the data encoded therein.

The fiducial mark type you specify must correspond to the feature finder that you are using. DotGridAxes is only supported for DotGrid. StandardRectangles is supported for Checkerboard, CheckerboardExhaustive, and CheckerboardEfficient. DataMatrix and DataMatrixWithGridPitch style fiducial marks are supported for Checkerboard, CheckerboardExhaustive, CheckerboardExhaustiveMultiRegion, CheckerboardEfficient, and CheckerboardEfficientMultiRegion feature finding.