CogHandEyeCalibratorRemoteCameras.Execute Method (CogHandEyeCalibrationResults, CogFeaturePositionsMCamerasNPoses, Rectangle[], CogFeaturePositionsMCamerasNPoses)

CogHandEyeCalibratorRemoteCameras Execute Method (CogHandEyeCalibrationResults, CogFeaturePositionsMCamerasNPoses, Rectangle , CogFeaturePositionsMCamerasNPoses)

Cognex VisionPro 9.5

Compute the CogHandEyeCalibrationRemoteCamerasResults for the remote cameras based on the supplied hand-eye calibration results of the primary cameras, the tracked feature points on a part from both primary station and remote station, and pelrects of remote cameras.

Note that it requires the primary cameras and remote cameras must have overlapped tracked features in their FOVs when moving the part between primary station and remote station (via the highly repeatable motion).

Note that the tracked Raw2D features' order must be the same over all primary/remote cameras and over all poses.

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

Syntax

C++

Copy to Clipboard Print

public CogHandEyeCalibrationRemoteCameraResults Execute(
	CogHandEyeCalibrationResults primaryCamerasCalibResults,
	CogFeaturePositionsMCamerasNPoses primaryCamerasTrackedRaw2DFeatures,
	Rectangle[] remoteCamerasPelRects,
	CogFeaturePositionsMCamerasNPoses remoteCamerasTrackedRaw2DFeatures
)

public CogHandEyeCalibrationRemoteCameraResults Execute(
	CogHandEyeCalibrationResults primaryCamerasCalibResults,
	CogFeaturePositionsMCamerasNPoses primaryCamerasTrackedRaw2DFeatures,
	Rectangle[] remoteCamerasPelRects,
	CogFeaturePositionsMCamerasNPoses remoteCamerasTrackedRaw2DFeatures
)

Public Function Execute ( 
	primaryCamerasCalibResults As CogHandEyeCalibrationResults,
	primaryCamerasTrackedRaw2DFeatures As CogFeaturePositionsMCamerasNPoses,
	remoteCamerasPelRects As Rectangle(),
	remoteCamerasTrackedRaw2DFeatures As CogFeaturePositionsMCamerasNPoses
) As CogHandEyeCalibrationRemoteCameraResults

Public Function Execute ( 
	primaryCamerasCalibResults As CogHandEyeCalibrationResults,
	primaryCamerasTrackedRaw2DFeatures As CogFeaturePositionsMCamerasNPoses,
	remoteCamerasPelRects As Rectangle(),
	remoteCamerasTrackedRaw2DFeatures As CogFeaturePositionsMCamerasNPoses
) As CogHandEyeCalibrationRemoteCameraResults

public:
CogHandEyeCalibrationRemoteCameraResults^ Execute(
	CogHandEyeCalibrationResults^ primaryCamerasCalibResults, 
	CogFeaturePositionsMCamerasNPoses^ primaryCamerasTrackedRaw2DFeatures, 
	array<Rectangle>^ remoteCamerasPelRects, 
	CogFeaturePositionsMCamerasNPoses^ remoteCamerasTrackedRaw2DFeatures
)

public:
CogHandEyeCalibrationRemoteCameraResults^ Execute(
	CogHandEyeCalibrationResults^ primaryCamerasCalibResults, 
	CogFeaturePositionsMCamerasNPoses^ primaryCamerasTrackedRaw2DFeatures, 
	array<Rectangle>^ remoteCamerasPelRects, 
	CogFeaturePositionsMCamerasNPoses^ remoteCamerasTrackedRaw2DFeatures
)

Parameters

primaryCamerasCalibResults: Type: Cognex.VisionPro.CalibFix CogHandEyeCalibrationResults
The primary cameras' hand-eye calibration results.

primaryCamerasTrackedRaw2DFeatures: Type: Cognex.VisionPro CogFeaturePositionsMCamerasNPoses
The tracked Raw2D feature positions from the images acquired by the primary cameras. Each tracked Raw2D feature includes x,y coordinates and a validation value. For different poseID of i, primaryCamerasTrackedRaw2DFeatures[i][cameraID][featureID] (with the same cameraID and featureID) should always correspond to the same physical feature. The validation value indicates whether this feature is visible in current camera under current pose.

remoteCamerasPelRects: Type: System.Drawing Rectangle
The pelrects of the remote cameras. There should be one pelrect for each camera. There is no relationship between the pelrects of two separate cameras. It is used to define the camera coordinate system (i.e. Camera2D) to be at the center of the pelrect.

remoteCamerasTrackedRaw2DFeatures: Type: Cognex.VisionPro CogFeaturePositionsMCamerasNPoses
The tracked Raw2D feature positions from the images acquired by the remote cameras. Each tracked Raw2D feature includes x,y coordinates and a validation value. For different poseID of i, remoteCamerasTrackedRaw2DFeatures[i][cameraID][featureID] (with the same cameraID and featureID) should always correspond to the same physical feature. The validation value indicates whether this feature is visible in current camera under current pose.

Return Value

Type: CogHandEyeCalibrationRemoteCameraResults
A CogHandEyeCalibrationRemoteCameraResults containing the results of the calibration, i.e. a CogHandEyeCalibrationRemoteCameraResult object for each remote camera.

Exceptions

Exception	Condition
ArgumentNullException	If the primaryCamerasCalibResults argument is null.
ArgumentNullException	If the primaryCamerasTrackedRaw2DFeatures argument is null.
ArgumentNullException	If the remoteCamerasPelRects argument is null.
ArgumentNullException	If the remoteCamerasTrackedRaw2DFeatures argument is null.
CogTimeoutExpiredException	If TimeoutEnabled is true and this method does not complete within Timeout milliseconds.
ArgumentException	If any of the following is true: Any of the input arguments is empty. primaryCamerasTrackedRaw2DFeatures[i].Count != primaryCamerasCalibResults.Count for any pose i. primaryCamerasTrackedRaw2DFeatures.Count != remoteCamerasTrackedRaw2DFeatures.Count remoteCamerasTrackedRaw2DFeatures[i].Count != remoteCamerasPelRects.Count for any pose i primaryCamerasTrackedRaw2DFeatures[i1][j].Count != primaryCamerasTrackedRaw2DFeatures[i2][j].Count for any j. remoteCamerasTrackedRaw2DFeatures[i1][j].Count != remoteCamerasTrackedRaw2DFeatures[i2][j].Count for any j. primaryCamerasTrackedRaw2DFeatures[i1][j1].Count != remoteCamerasTrackedRaw2DFeatures [i2][j2].Count for any i1, j1, i2, j2.
ArgumentException	If any Raw2D feature position in the remoteCamerasTrackedRaw2DFeatures argument falls outside its corresponding pelrect.
ArgumentException	If the input data is degenerate.