CogCalibNPointToNPoint Execute Method Cognex VisionPro 9.7
Attaches the calibrated space to the coordinate tree of the input image, using the given RunParams, and returns a shallow copy of the image as an output.

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

public ICogImage Execute(
	ICogImage inputImage,
	CogCalibNPointToNPointRunParams runParams
)

Parameters

inputImage
Type: Cognex.VisionPro ICogImage

The input image on which to perform the N-point-to-N-point calibration.

runParams
Type: Cognex.VisionPro.CalibFix CogCalibNPointToNPointRunParams

The run-time parameters for the N-point-to-N-point calibration.

Return Value

Type: ICogImage

The output image.

Exceptions

ExceptionCondition
CogOperatorNoInputImageException

inputImage is NULL.

CogOperatorNoRunParamsException

runParams is NULL.

CogCalibFixNotCalibratedException

The Calibrated property is False.

Remarks

Attaches the adjusted calibrated space to the coordinate space tree of the input image, using the given RunParams, and returns a shallow copy of the image as an output.

The new coordinate space is defined by the UncalibratedFromCalibrated transform last computed by this object, and is attached to the coordinate space tree as a copy. Its nonqualified space name is given by the CalibratedSpaceNamerunParams.

The new output image shares the pixels and tree of the input image, and its selected space name is determined by the SpaceToOutput of runParams. This space name is either the fully-qualified name of the calibrated space or the fully-qualified name of the uncalibrated space.

No error results if the calibrated space already exists in the coordinate space tree of the input image prior to running the Execute(ICogImage, CogCalibNPointToNPointRunParams) method. Instead, the existing definition of the calibrated space is updated using the computed UncalibratedFromCalibrated transform. If errors do occur during Execute(ICogImage, CogCalibNPointToNPointRunParams), this method does not return an image: the OutputImage is set to Nothing or Null.

See Also