Cog3DShapeProjector.Execute Method (Cog3DVect3, Cog3DTransformRigid, Cog3DCameraCalibration, String, CogGraphicCollection)

Cog3DShapeProjector Execute Method (Cog3DVect3, Cog3DTransformRigid, Cog3DCameraCalibration, String, CogGraphicCollection)

Cognex VisionPro

Maps 3D coordinate axes using the phys3DFromAxes3D transform. Then projects the mapped 3D coordinate axes using the raw2DFromPhys3D camera calibration onto the image plane. The projected axes, along with x, y, z text and specified label are then rendered as VisionPro graphics and appended to the specified graphicsCollection.

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

Syntax

C++

Copy to Clipboard Print

public void Execute(
	Cog3DVect3 lengthAxes3D,
	Cog3DTransformRigid phys3DFromAxes3D,
	Cog3DCameraCalibration raw2DFromPhys3D,
	string label,
	CogGraphicCollection graphicCollection
)

public void Execute(
	Cog3DVect3 lengthAxes3D,
	Cog3DTransformRigid phys3DFromAxes3D,
	Cog3DCameraCalibration raw2DFromPhys3D,
	string label,
	CogGraphicCollection graphicCollection
)

Public Sub Execute ( 
	lengthAxes3D As Cog3DVect3,
	phys3DFromAxes3D As Cog3DTransformRigid,
	raw2DFromPhys3D As Cog3DCameraCalibration,
	label As String,
	graphicCollection As CogGraphicCollection
)

Public Sub Execute ( 
	lengthAxes3D As Cog3DVect3,
	phys3DFromAxes3D As Cog3DTransformRigid,
	raw2DFromPhys3D As Cog3DCameraCalibration,
	label As String,
	graphicCollection As CogGraphicCollection
)

public:
void Execute(
	Cog3DVect3 lengthAxes3D, 
	Cog3DTransformRigid^ phys3DFromAxes3D, 
	Cog3DCameraCalibration^ raw2DFromPhys3D, 
	String^ label, 
	CogGraphicCollection^ graphicCollection
)

public:
void Execute(
	Cog3DVect3 lengthAxes3D, 
	Cog3DTransformRigid^ phys3DFromAxes3D, 
	Cog3DCameraCalibration^ raw2DFromPhys3D, 
	String^ label, 
	CogGraphicCollection^ graphicCollection
)

Parameters

lengthAxes3D: Type: Cognex.VisionPro3D Cog3DVect3
The 3D vector representing the physical length of the X, Y, and Z coordinate axes to be projected and rendered.

phys3DFromAxes3D: Type: Cognex.VisionPro3D Cog3DTransformRigid
The rigid transform used to specify the pose of the 3D coordinate axes in the Phys3D coordinate space of the specified raw2DFromPhys3D camera calibration. This parameter can be null to signify an identity transform should be used.

raw2DFromPhys3D: Type: Cognex.VisionPro3D Cog3DCameraCalibration
The camera calibration used for projecting the 3D coordinate axes onto an acquired image. May not be null.

label: Type: System String
The specified label for the 3D coordinate axes. If it is null, then the label string is empty.

graphicCollection: Type: Cognex.VisionPro CogGraphicCollection
The VisionPro graphics collection the projected and rendered axes are appended to.

Exceptions

Exception	Condition
ArgumentException	If lengthAxes3D is zero or negative in any dimension.
ArgumentNullException	if raw2DFromPhys3D, or graphicCollection is null.