CogImage16Range.MapPoint3DFrom2D Method

CogImage16Range MapPoint3DFrom2D Method

Cognex VisionPro 9.20

Maps the supplied two dimensional point into the specified three dimensional space. This is accomplished by first mapping the input two dimensional point to pixel space. If the range image's visible pixel mask indicates that this pixel was not visible, then the Visible output argument is set to false and no further processing is performed. Otherwise, the pixel value is read. This range image pixel value is incremented by 0.5 to place it at a "middle" height within the subject voxel. The resulting pixel space coordinate triple is mapped into the requested three dimensional space.

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

Syntax

C++

Copy to Clipboard Print

public void MapPoint3DFrom2D(
	string DstPoint3DSpaceName,
	string SrcPoint2DSpaceName,
	Cog3DVect2 SrcPoint2D,
	out bool Visible,
	out Cog3DVect3 DstPoint3D
)

public void MapPoint3DFrom2D(
	string DstPoint3DSpaceName,
	string SrcPoint2DSpaceName,
	Cog3DVect2 SrcPoint2D,
	out bool Visible,
	out Cog3DVect3 DstPoint3D
)

Public Sub MapPoint3DFrom2D ( 
	DstPoint3DSpaceName As String,
	SrcPoint2DSpaceName As String,
	SrcPoint2D As Cog3DVect2,
	<OutAttribute> ByRef Visible As Boolean,
	<OutAttribute> ByRef DstPoint3D As Cog3DVect3
)

Public Sub MapPoint3DFrom2D ( 
	DstPoint3DSpaceName As String,
	SrcPoint2DSpaceName As String,
	SrcPoint2D As Cog3DVect2,
	<OutAttribute> ByRef Visible As Boolean,
	<OutAttribute> ByRef DstPoint3D As Cog3DVect3
)

public:
void MapPoint3DFrom2D(
	String^ DstPoint3DSpaceName, 
	String^ SrcPoint2DSpaceName, 
	Cog3DVect2 SrcPoint2D, 
	[OutAttribute] bool% Visible, 
	[OutAttribute] Cog3DVect3% DstPoint3D
)

public:
void MapPoint3DFrom2D(
	String^ DstPoint3DSpaceName, 
	String^ SrcPoint2DSpaceName, 
	Cog3DVect2 SrcPoint2D, 
	[OutAttribute] bool% Visible, 
	[OutAttribute] Cog3DVect3% DstPoint3D
)

Parameters

DstPoint3DSpaceName: Type: System String
The destination three dimensional space name.

SrcPoint2DSpaceName: Type: System String
The source two dimensional space name.

SrcPoint2D: Type: Cognex.VisionPro3D Cog3DVect2
The source two dimensional point.

Visible: Type: System Boolean
True if the source two dimensional point was visible.

DstPoint3D: Type: Cognex.VisionPro3D Cog3DVect3
The resulting mapped three dimensional point. This will be 0,0,0 if Visible is false.

Exceptions

Exception	Condition
ArgumentNullException	If DstPoint3DSpaceName is null.
ArgumentNullException	If SrcPoint2DSpaceName is null.
CogImageNoPixelsException	If Allocated is false.