ICog3DPointCloud.GetTransform3D Method

ICog3DPointCloud GetTransform3D Method

Cognex VisionPro 9.7

Returns a transform that maps three dimensional points from the 'From' space to the 'To' space. The special string "." is accepted as an alias for the SelectedSpaceName3D of this point cloud.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro.CorePlus (in Cognex.VisionPro.CorePlus.dll) Version: 73.0.0.0

Syntax

C++

Copy to Clipboard Print

ICog3DTransform GetTransform3D(
	string ToSpaceName,
	string FromSpaceName
)

ICog3DTransform GetTransform3D(
	string ToSpaceName,
	string FromSpaceName
)

Function GetTransform3D ( 
	ToSpaceName As String,
	FromSpaceName As String
) As ICog3DTransform

Function GetTransform3D ( 
	ToSpaceName As String,
	FromSpaceName As String
) As ICog3DTransform

ICog3DTransform^ GetTransform3D(
	String^ ToSpaceName, 
	String^ FromSpaceName
)

ICog3DTransform^ GetTransform3D(
	String^ ToSpaceName, 
	String^ FromSpaceName
)

Parameters

ToSpaceName: Type: System String
The name of the three dimensional coordinate space to transform the point to. The special string "." is accepted as an alias for the SelectedSpaceName3D of this point cloud.

FromSpaceName: Type: System String
The name of the three dimensional coordinate space to transform the point from. The special string "." is accepted as an alias for the SelectedSpaceName3D of this point cloud.

Return Value

Type: ICog3DTransform

Exceptions

Exception	Condition
ArgumentNullException	If ToSpaceName is null.
ArgumentNullException	If FromSpaceName is null.
CogSpaceTreeNameNotInTreeException	If either space name is not found in the CoordinateSpaceTree3D.

Remarks

In VisionPro point clouds, '#' is shorthand for the coordinate space in which points are stored. This is analagous to the way it is used to refer to pixel space coordinates in a VisionPro image. Some point clouds support multiple roots and some do not. For those that do, we honor the notation "#n", in which n can have values 0, 1, 2, and so on. So coordinates in the storage space of the third root in a point cloud could be referenced as "#2".