CogImage16Range.MapPoints3DFrom2D Method

CogImage16Range MapPoints3DFrom2D Method

Cognex VisionPro 9.8 SR1

Maps the supplied collection of two dimensional points into the specified three dimensional space. This is accomplished by first mapping an input two dimensional point into pixel space. If the range image's visible pixel mask indicates that this pixel was not visible, then the corresponding element in the output Visible array is set to false and the corresponding element in the output DstPoints3D collection is set to a default (0,0,0) value. 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: 75.0.0.0

Syntax

C++

Copy to Clipboard Print

public void MapPoints3DFrom2D(
	string DstPoint3DSpaceName,
	string SrcPoint2DSpaceName,
	Cog3DVect2Collection SrcPoints2D,
	out bool[] Visible,
	out Cog3DVect3Collection DstPoints3D
)

public void MapPoints3DFrom2D(
	string DstPoint3DSpaceName,
	string SrcPoint2DSpaceName,
	Cog3DVect2Collection SrcPoints2D,
	out bool[] Visible,
	out Cog3DVect3Collection DstPoints3D
)

Public Sub MapPoints3DFrom2D ( 
	DstPoint3DSpaceName As String,
	SrcPoint2DSpaceName As String,
	SrcPoints2D As Cog3DVect2Collection,
	<OutAttribute> ByRef Visible As Boolean(),
	<OutAttribute> ByRef DstPoints3D As Cog3DVect3Collection
)

Public Sub MapPoints3DFrom2D ( 
	DstPoint3DSpaceName As String,
	SrcPoint2DSpaceName As String,
	SrcPoints2D As Cog3DVect2Collection,
	<OutAttribute> ByRef Visible As Boolean(),
	<OutAttribute> ByRef DstPoints3D As Cog3DVect3Collection
)

public:
void MapPoints3DFrom2D(
	String^ DstPoint3DSpaceName, 
	String^ SrcPoint2DSpaceName, 
	Cog3DVect2Collection^ SrcPoints2D, 
	[OutAttribute] array<bool>^% Visible, 
	[OutAttribute] Cog3DVect3Collection^% DstPoints3D
)

public:
void MapPoints3DFrom2D(
	String^ DstPoint3DSpaceName, 
	String^ SrcPoint2DSpaceName, 
	Cog3DVect2Collection^ SrcPoints2D, 
	[OutAttribute] array<bool>^% Visible, 
	[OutAttribute] Cog3DVect3Collection^% DstPoints3D
)

Parameters

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

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

SrcPoints2D: Type: Cognex.VisionPro3D Cog3DVect2Collection
The source two dimensional point collection.

Visible: Type: System Boolean
An output array of boolean values indicating which input points were visible. The number of elements in this array will equal the number of input points.

DstPoints3D: Type: Cognex.VisionPro3D Cog3DVect3Collection
The resulting mapped three dimensional points. Any element corresponding to an input point that was not visible will have the value 0,0,0. This collection will have the same size as the input point collection.

Exceptions

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