MeshProjIntersect : ReferenceTarget

MeshProjIntersect - superclass: ReferenceTarget; super-superclass:MAXWrapper - 0:0 - classID: #(1266304708, 865233301) 

This class exposes an interface that is used by the ProjectionMappingtools to find the projection of one mesh point onto another mesh.

MeshProjIntersect interfaces:

Interface: rayMeshProjIntersectOps 

Methods:

<void>SetNode <node>node 

Sets the node to perform the intersections on.Multiple nodes can be added to the same instance of the intersector interface. Use the GetHitNode() method to determine which of the nodes added to the intersector was hit.

<void>Build () 

Builds the internal data structures for fast intersections.This method has to be called after adding the nodes.

<void>Free () 

Removes the internal data structures, frees memory.

<boolean>ProjectionFace <integer>triIndex <point3 by value>triBary 

Performs a face projection.

The triIndex argument is the 0-based face index.

The triBary argument specifies the barycentric coordinates of the point in the face.

Returns true on success, false if no valid projection could be performed.

When performing Projection Mapping, a low-resolution working model and a high-resolution reference model are used. A cage is defined around the working model which has to completely surround the reference model. Every point on the high-resolution reference model corresponds to a point on the low-resolution working model. There can be multiple reference modes for one working model.

To use this method,

• Create an instance of the MeshProjIntersect class.

• Call SetNode() passing the low-resolution working modeland call Build() to generate the acceleration data. It must have a Projection modifier applied.

• The Projection modifier must have one or more reference models defined. 

• Call the ProjectionFace() method with the face index and barycentric coordinates of any point on the surface of the working model.

As result, the ProjectionFace() method sets the internal values to hits on the reference models. The method getHitNode() will return the reference model that was hit, getHitFace() will return the face index, getHitPos() will return the position of the hit and so on.See further on this page for details.

<boolean>ClosestFace <point3 by value>point dir:<point3 by value>caged:<boolean> doubleSided:<boolean> 
dir default value: [0,0,0] 
caged default value: false 
doubleSided default value: false 

Returns the closest face to the given point is space.

If the optional dir: keyword parameter is supplied and is not [0,0,0], the closest face in the given direction is detected.

If the optional doubleSided: keyword parameter is supplied and is true, both facing and backfacing faces will be considered.

Returns true if a closest face has been found, false otherwise.

<fpvalue by value>GetHitDist hitIndex:<integer> 
hitIndex default value: -1 

Returns the distance to the hit.

If the optional hitIndex: keyword argument is not supplied or is supplied as -1, the closest hit is returned. If it is supplied and is a positive integer, the distance to the corresponding indexed hit is returned.See warning below.

<fpvalue by value>GetHitNode hitIndex:<integer> 
hitIndex default value: -1 

Returns the node that has been hit.

If the optional hitIndex: keyword argument is not supplied or is supplied as -1, the node of the closest hit is returned. If it is supplied and is a positive integer, the node of the corresponding indexed hit is returned.

See previous warning regardinggetting data after a ClosestFace() call.

<fpvalue by value>GetHitFace hitIndex:<integer> 
hitIndex default value: -1 

Returns the ZERO-BASED indexof the face that has been hit.

If the optional hitIndex: keyword argument is not supplied or is supplied as -1, the closest face hit is returned. If it is supplied and is a positive integer, the face of the corresponding indexed hit is returned.

See previous warning regarding getting data after a ClosestFace() call.

<fpvalue by value>GetHitBary hitIndex:<integer> 
hitIndex default value: -1 

Returns the barycentric coordinates of the hit.

If the optional hitIndex : keyword argument is not supplied or is supplied as -1, the barycentric coordinates of the closest hit are returned. If it is supplied and is a positive integer, the barycentric coordinates of the corresponding indexed hit are returned.

See previous warning regarding getting data after a ClosestFace() call.

<fpvalue by value>GetHitBackfacing hitIndex:<integer> 
hitIndex default value: -1 

Returns the backfacing hit.

If the optional hitIndex: keyword argument is not supplied or is supplied as -1, the closest backfacing hit is returned. If it is supplied and is a positive integer, the corresponding indexed backfacing hit is returned.

See previous warning regarding getting data after a ClosestFace() call.

<fpvalue by value>GetHitPos hitIndex:<integer> 
hitIndex default value: -1 

Returns the world position of the hit.

If the optional hitIndex: keyword argument is not supplied or is supplied as -1, the position of the closest hit is returned. If it is supplied and is a positive integer, the position of the corresponding indexed hit is returned.

See previous warning regarding getting data after a ClosestFace() call.

<boolean>IntersectRay <point3 by value>point <point3 by value>dir doubleSided:<boolean> 
doubleSided default value: false 

Performs a ray intersection with the nodes set using SetNode() from the world space position defined by the point parameter in the direction of the vector specified by the dir parameter.

If the optional doubleSided: keyword parameter is supplied and is true, intersections will be performed with both the front and the backside of the faces.

Returns true if the ray has hit any faces, false if there was no intersection.

 Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.