Description
Outputs the closest location on a surface, polygon mesh, curve, or point cloud based on the input position. Locations are
"glued" to the surface of a geometry so that they stay in the same relative position even as the geometry transforms and deforms,
unless you recompute and reset the locations' values at different frames. In the specific case of a point cloud, this node
returns a location that corresponds to the closest particle and moves with that particle.
We strongly suggest, when possible, to use the cutoff distance option for performance reason. The smaller the cutoff distance,
the faster the execution of this node.
If no location is found within the cutoff distance, a value of Undefined Location is returned for that element. If you try
to get an attribute at Undefined Location, the value is filtered — subsequent nodes do not process that element of the data
set.
Parameters
|
Method used to compute the proximity:
-
finds the nearest point on the input object's surface.
-
finds the closest vertex on polygon meshes, or the closest knot on curves and NURBS surfaces.
-
is a variation of Closest Surface that helps avoid stretching at sharp corners and other situations. For example, in the
image below, the closest location on the smaller cube is the same for all points on the cross-section of the larger cube's
bevel. This method detects such situations and compensates by spreading out the returned locations.
|
Ports
Inputs
|
The geometry on which we want the closest location.
|
|
The position from which we want the closest location.
|
|
Allows to search only within given distance.
|
|
The distance within which to search when the Enable Cutoff Distance option is turned on.
|
Outputs
|
The closest location on the geometry from the input position.
|
|
Returns true if a location was found on the geometry within the cutoff distance (when the option is on).
|