ICogCalibCheckerboardWarpParams WarpDestinationRectangle Property Cognex VisionPro 9.7
Rectangle of the undistorted calibration image that specifies what pixels will be present in the warped (runtime) output image. If the rectangle is Nothing, all the pixels of the undistorted image will be output. It must be in '.', '@', or '#' space.

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

CogRectangle WarpDestinationRectangle { get; set; }

Property Value

Type: CogRectangle
Events

Event TypeReason
CogCalibCheckerboard Changed

In linear mode, fires when the value of this property changes. In warping mode, fires when the value of this property changes and step 4 has not completed.

The following state flag may be affected:

CogCalibCheckerboard Changed

In warping mode, fires when the value of this property changes and step 4 has been completed. If step 5 was completed, the following state flags are affected:

Exceptions

ExceptionCondition
ArgumentException

The selected space name of the rectangle was not '.', '@', or '#'.

Remarks

Rectangle of the undistorted calibration image that specifies what pixels will be present in the warped (runtime) output image. If the rectangle is Nothing, all the pixels of the undistorted image will be output. It must be in '.', '@', or '#' space.

This rectangle, which is expressed in pixel space of the UndistortedCalibrationImage, specifies the size and position of the run-time OutputImage. The rectangle you specify is rounded to integer coordinates and its intersection with the UndistortedCalibrationImage is computed to produce the final output image. If this rectangle does not intersect with the UndistortedCalibrationImage, Calibrate  returns an error.

Note: Changing this rectangle untrains the tool.

Default Value: Null

See Also