Cog3DShapeGeometricOperations.Intersect Method (Cog3DPlane, Cog3DRay, Cog3DVect3, Cog3DShapeIntersectionStatusConstants)

Cog3DShapeGeometricOperations Intersect Method (Cog3DPlane, Cog3DRay, Cog3DVect3 , Cog3DShapeIntersectionStatusConstants )

Cognex VisionPro 9.20

Compute the intersection point between the given plane and the given 3D ray. 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: 80.0.0.0

Syntax

C++

Copy to Clipboard Print

public static void Intersect(
	Cog3DPlane plane3D,
	Cog3DRay ray3D,
	out Cog3DVect3 point3D,
	out Cog3DShapeIntersectionStatusConstants intersectionStatus
)

public static void Intersect(
	Cog3DPlane plane3D,
	Cog3DRay ray3D,
	out Cog3DVect3 point3D,
	out Cog3DShapeIntersectionStatusConstants intersectionStatus
)

Public Shared Sub Intersect ( 
	plane3D As Cog3DPlane,
	ray3D As Cog3DRay,
	<OutAttribute> ByRef point3D As Cog3DVect3,
	<OutAttribute> ByRef intersectionStatus As Cog3DShapeIntersectionStatusConstants
)

Public Shared Sub Intersect ( 
	plane3D As Cog3DPlane,
	ray3D As Cog3DRay,
	<OutAttribute> ByRef point3D As Cog3DVect3,
	<OutAttribute> ByRef intersectionStatus As Cog3DShapeIntersectionStatusConstants
)

public:
static void Intersect(
	Cog3DPlane^ plane3D, 
	Cog3DRay^ ray3D, 
	[OutAttribute] Cog3DVect3% point3D, 
	[OutAttribute] Cog3DShapeIntersectionStatusConstants% intersectionStatus
)

public:
static void Intersect(
	Cog3DPlane^ plane3D, 
	Cog3DRay^ ray3D, 
	[OutAttribute] Cog3DVect3% point3D, 
	[OutAttribute] Cog3DShapeIntersectionStatusConstants% intersectionStatus
)

Parameters

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

ray3D: Type: Cognex.VisionPro3D Cog3DRay
The 3D ray. May not be null.

point3D: Type: Cognex.VisionPro3D Cog3DVect3
This output parameter is used to keep the intersection point.

intersectionStatus: Type: Cognex.VisionPro3D Cog3DShapeIntersectionStatusConstants
This output parameter is used to keep the intersection status.

Exceptions

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

Remarks

point3D is valid if and only if intersectionStatus is Cog3DShapeIntersectionStatusConstants.Intersect, and unchanged otherwise.

intersectionStatus is Cog3DShapeIntersectionStatusConstants.Overlap if ray3D is on plane3D.

intersectionStatus is Cog3DShapeIntersectionStatusConstants.None if ray3D is parallel to plane3D or if ray3D is pointing away from plane3D.

An intersection will not be found if ray3D is pointing away from plane3D.