CogCalibFeatureExtractorCheckerboardLabelModeConstants EnumerationCognex VisionPro
This class defines enumeration constants to define the label mode of the vertices on the checkerboard, i.e., how to set the origin and axes of Grid2D.

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

[FlagsAttribute]
public enum CogCalibFeatureExtractorCheckerboardLabelModeConstants
Members

  Member nameValueDescription
None0 Under this label mode, the origin of the Grid2D coordinate system is set at the vertex closest to the center of the image. The Grid2D x-axis (resp. Grid2D y-axis) is set to be the direction of a row or a column of vertices along which x-components (resp. y-components) of images coordinates of vertices increase faster.
UseOrigin1 This specifies that the vertex closest to a designated origin location be used as the origin of the Grid2D coordinate system. The designated origin can be set using the properties OriginX and OriginY. The direction of the axes is set exactly as in None label mode.
UseFiducial2 This specifies that a Cognex specific fiducial target will be located and used for setting the Grid2D coordinate system. An example can be found in the specification of Cognex calibration plate with Cognex part number of 320-0015.
UseDataMatrix3 This specifies that standard Data Matrix codes are to be used as calibration fiducials that are uniquely identifiable in the calibration target. This mode will ignore any information about the physical grid pitch that may be encoded in the Data Matrix codes, and will instead use PhysGridPitchX and PhysGridPitchY in CogCalibFeatureExtractorCheckerboard.

For the specification of supported data matrix codes, please read the related user help documents.

UseDataMatrixWithGridPitch4 This is similar to UseDataMatrix, but in this mode, the tool will ignore PhysGridPitchX and PhysGridPitchY in CogCalibFeatureExtractorCheckerboard, and will instead use the value of physical grid pitch encoded in the Data Matrix codes.
Remarks

Grid2D coordinate system: This coordinate system defines coordinates of points in the plane of the calibration plate; the origin of the coordinate system is at one of the vertices, the directions of the x-axis and y-axis are along the lines through a row of vertices and column of vertices respectively. The unit of measurement along each axis is specified in tiles.

Plate2D coordinate system: Similar to Grid2D, this coordinate system defines coordinates of points in the plane of the calibration plate. It has the same origin as Grid2D and its axes have the same orientation as the Grid2D axes, but it has different measurement units than Grid2D. The units on the axes are defined by the pitch of the calibration plate checkers in physical units.

Further determination of the origin and axes of Grid2D depends on the label mode chosen, as described in comments for each label mode in this class.

Note that neither None nor UseOrigin label mode is appropriate if it is crucial to have the Grid2D coordinate system stationary with respect to the calibration plate (e.g. in calibration using multiple calibration poses), in those cases, other label modes must be used.

It is required that all checkers in the image are at least 15x15 pixels in size. If Data Matrix codes are used as calibration fiducials the Data Matrix codes should have a minimum resolution of 4 pixels per module (ppm).

See Also