Cog3DCoordinateSpaceTree.CopySubtree Method

Cog3DCoordinateSpaceTree CopySubtree Method

Cognex VisionPro 9.5

Return a copy of the subtree rooted at SpaceName.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D.Core (in Cognex.VisionPro3D.Core.dll) Version: 69.0.0.0

Syntax

public Cog3DCoordinateSpaceTree CopySubtree(
	string spaceName
)

public Cog3DCoordinateSpaceTree CopySubtree(
	string spaceName
)

Public Function CopySubtree ( 
	spaceName As String
) As Cog3DCoordinateSpaceTree

Public Function CopySubtree ( 
	spaceName As String
) As Cog3DCoordinateSpaceTree

public:
Cog3DCoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

public:
Cog3DCoordinateSpaceTree^ CopySubtree(
	String^ spaceName
)

spaceName: Type: System String
A valid nonqualified or fully-qualified space name that indicates the root space of the subtree to copy.

The copied coordinate space subtree.

Exceptions

Exception	Condition
CogSpaceTreeInvalidNameSyntaxException	spaceName is not a legal space name.
CogSpaceTreeNameNotUniqueException	spaceName is a nonqualified space name and more than one instance of it exists in this tree.
CogSpaceTreeNameNotInTreeException	spaceName does not exist in this tree.

Remarks

Returns a copy of the subtree rooted at the given space name. The returned tree contains a shallow copy of any trees embedded in this tree using the AddTree(String, Cog3DCoordinateSpaceTree, ICog3DTransform, CogAddSpaceConstants) method.