Cog3DShapeGeometricOperations.ProjectOntoPlane Method (Cog3DPlane, Cog3DLineSeg, Cog3DLineSeg, Cog3DShapeProjectionStatusConstants)

Cog3DShapeGeometricOperations ProjectOntoPlane Method (Cog3DPlane, Cog3DLineSeg, Cog3DLineSeg , Cog3DShapeProjectionStatusConstants )

Cognex VisionPro 9.8

Project a 3D line segment onto a specified 3D plane. It is the caller responsibility to map the shapes to a common 3D space before calling this method.

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

Syntax

C++

Copy to Clipboard Print

public static void ProjectOntoPlane(
	Cog3DPlane plane3D,
	Cog3DLineSeg lineSeg3D,
	out Cog3DLineSeg projectedLineSeg3D,
	out Cog3DShapeProjectionStatusConstants projectionStatus
)

public static void ProjectOntoPlane(
	Cog3DPlane plane3D,
	Cog3DLineSeg lineSeg3D,
	out Cog3DLineSeg projectedLineSeg3D,
	out Cog3DShapeProjectionStatusConstants projectionStatus
)

Public Shared Sub ProjectOntoPlane ( 
	plane3D As Cog3DPlane,
	lineSeg3D As Cog3DLineSeg,
	<OutAttribute> ByRef projectedLineSeg3D As Cog3DLineSeg,
	<OutAttribute> ByRef projectionStatus As Cog3DShapeProjectionStatusConstants
)

Public Shared Sub ProjectOntoPlane ( 
	plane3D As Cog3DPlane,
	lineSeg3D As Cog3DLineSeg,
	<OutAttribute> ByRef projectedLineSeg3D As Cog3DLineSeg,
	<OutAttribute> ByRef projectionStatus As Cog3DShapeProjectionStatusConstants
)

public:
static void ProjectOntoPlane(
	Cog3DPlane^ plane3D, 
	Cog3DLineSeg^ lineSeg3D, 
	[OutAttribute] Cog3DLineSeg^% projectedLineSeg3D, 
	[OutAttribute] Cog3DShapeProjectionStatusConstants% projectionStatus
)

public:
static void ProjectOntoPlane(
	Cog3DPlane^ plane3D, 
	Cog3DLineSeg^ lineSeg3D, 
	[OutAttribute] Cog3DLineSeg^% projectedLineSeg3D, 
	[OutAttribute] Cog3DShapeProjectionStatusConstants% projectionStatus
)

Parameters

plane3D: Type: Cognex.VisionPro3D Cog3DPlane
The 3D plane to project onto. May not be null.

lineSeg3D: Type: Cognex.VisionPro3D Cog3DLineSeg
The 3D line segment. May not be null.

projectedLineSeg3D: Type: Cognex.VisionPro3D Cog3DLineSeg
This output parameter is used to keep the projected line segment.

projectionStatus: Type: Cognex.VisionPro3D Cog3DShapeProjectionStatusConstants
This output parameter is used to keep the projection status.

Exceptions

Exception	Condition
ArgumentNullException	If plane3D or lineSeg3D is null.
ArgumentException	If plane3D is degenerate or lineSeg3D is degenerate.

Remarks

If projectionStatus is Cog3DShapeProjectionStatusConstants.DegenerateProjection, projectedLineSeg3D will be a degenerate line segment.