CogFixture Execute Method Cognex VisionPro
Attaches the fixtured space to the coordinate tree of the input image, using the FixturedSpaceName property. Returns a shallow copy of the image as an output. The selected space of the output image is chosen using the SpaceToOutput property.

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

public ICogImage Execute(
	ICogImage inputImage
)

Return Value

Type: ICogImage

The output image.

Exceptions

ExceptionCondition
CogOperatorNoInputImageException

inputImage is NULL.

Remarks

Attaches the fixtured space to the coordinate tree of the input image, using the space name value of the FixturedSpaceName property, and returns a shallow copy of the image as an output image. The selected space of the output image is determined by the SpaceToOutput property.

The new coordinate space is defined by the UnfixturedFromFixtured transform, and is attached to the coordinate space tree as a copy. Its nonqualified space name is given by the FixturedSpaceName property and the selected space of the input image is the unfixtured space.

The new output image shares the pixels and tree of the input image. Its selected space name is determined by the SpaceToOutput property of the RunParams object. The name is either the fully-qualified name of the fixtured space or the fully-qualified name of the unfixtured space.

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

See Also