RFMeshTools.FindRayIntersectionSingleDirection (Available After rapidform2006)

Description

Calculates the first intersection point between specified half-infinite line and shell, and retrieves the RFHandle of newly created encoded face set structure.

Syntax

Function RFMeshTools.FindRayIntersectionSingleDirection(hEncodedFaceSet As RFHandle, pRayPoint As RFPoint3, pRayNormal As RFVector3, frontFaceOnly As Boolean, pIntPoint As RFPoint3, pIntDistance As Double, pIntFaceID As RFEntityID, pSuccess As Boolean) As RFErrorCode

The FindRayIntersectionSingleDirection syntax has these parts:

Part	Description
hEncodedFaceSet	[IN] RFHandle Required. Handle of the encoded face set structure.
pRayPoint	[IN] RFPoint3 Required. Origin of the half-infinite line.
pRayNormal	[IN] RFVector3 Required. Direction of the half-infinite line.
frontFaceOnly	[IN] Boolean Required. It determines whether visible faces along the pRayNorma direction are only considered.
pIntPoint	[OUT] RFPoint3 Required. The first intersection point on the shell.
pIntDistance	[OUT] Double Required. Distance between pRayPoint and pIntPoint.
pIntFaceID	[OUT] RFEntityID Required. Face's RFEntityID on which pIntPoint lies.
pSuccess	[OUT] Boolean Required. Boolean value indicating whether an intersection point is found.

Remarks

A ray is a half-infinite line which consists of an origin point and a direction vector. As intersection results, the intersection point of the shell pIntPoint, distance between pRayPoint and pIntPoint, and the face's RFEntityID on which the point pIntPoint lies are obtained when the intersection is found, which is indicated by the return Boolean value = TRUE.
To use this method, an encoded face set should be created in advance, which can be obtained by RFMeshTools.CreateEncodedFaceSet method.
With frontFaceOnly = TRUE option, faces that are visible along the ray’s normal direction are only considered.
To find a projection point based on minimum distance, use RFShell.ProjectPoint method.

Return to Rapidform Index

Your Ad Here