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

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

Cognex VisionPro 9.8

Project a 3D line 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,
	Cog3DLine line3D,
	out Cog3DLine projectedLine3D,
	out Cog3DShapeProjectionStatusConstants projectionStatus
)

public static void ProjectOntoPlane(
	Cog3DPlane plane3D,
	Cog3DLine line3D,
	out Cog3DLine projectedLine3D,
	out Cog3DShapeProjectionStatusConstants projectionStatus
)

Public Shared Sub ProjectOntoPlane ( 
	plane3D As Cog3DPlane,
	line3D As Cog3DLine,
	<OutAttribute> ByRef projectedLine3D As Cog3DLine,
	<OutAttribute> ByRef projectionStatus As Cog3DShapeProjectionStatusConstants
)

Public Shared Sub ProjectOntoPlane ( 
	plane3D As Cog3DPlane,
	line3D As Cog3DLine,
	<OutAttribute> ByRef projectedLine3D As Cog3DLine,
	<OutAttribute> ByRef projectionStatus As Cog3DShapeProjectionStatusConstants
)

public:
static void ProjectOntoPlane(
	Cog3DPlane^ plane3D, 
	Cog3DLine^ line3D, 
	[OutAttribute] Cog3DLine^% projectedLine3D, 
	[OutAttribute] Cog3DShapeProjectionStatusConstants% projectionStatus
)

public:
static void ProjectOntoPlane(
	Cog3DPlane^ plane3D, 
	Cog3DLine^ line3D, 
	[OutAttribute] Cog3DLine^% projectedLine3D, 
	[OutAttribute] Cog3DShapeProjectionStatusConstants% projectionStatus
)

Parameters

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

line3D: Type: Cognex.VisionPro3D Cog3DLine
The 3D line. May not be null.

projectedLine3D: Type: Cognex.VisionPro3D Cog3DLine
This output parameter is used to keep the projected line.

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

Exceptions

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

Remarks

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