Cog3DAlignResult GetVisionData Method Cognex VisionPro
Get a range image representation of the trained pattern points. This image has an attached coordinate space that can be used to rotate and translate the points to match the runtime pose of this result.

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

public ICogVisionData GetVisionData()

Return Value

Type: ICogVisionData
An ICogVisionData that can map the 3D pattern points to the found pose of this result.
Remarks

This method returns range image data containing the 3D points of the found pattern.

The returned data is identical to the data returned by GetTrainedVisionData , except that it has a different Cog3DCoordinateSpaceTree. The new 3D space tree contains a single coordinate space that matches the 3D selected space of the runtime image. The transform that defines this space can be used to mathematically rotate and translate the points of the trained pattern to match the runtime pose of this result.

If you pass the returned image, and the runtime image, to a Cog3DDisplayV2WF or Cog3DDisplayV2, you can visualize how the pose of this result aligns with the runtime image.

The returned ICogVisionData will be null if the SaveTrainedVisionDataInResults property was set to "false" at runtime.

Images of 3D data can be stored in a single CogImage16Range or stored in a CogVisionDataContainer as a matched pair, with one CogImage16Range holding the 3D data and one CogImage16Grey holding corresponding grey-level information. Either style of input is acceptable. Both objects are referred to by the term "vision data" and both support the ICogVisionData interface.

See Also