Difference between revisions of "LlGetClosestNavPoint"

From Second Life Wiki
Jump to navigation Jump to search
Line 11: Line 11:
caveats=
caveats=
* There is no guarantee that a path exists from your current location to the returned point.
* There is no guarantee that a path exists from your current location to the returned point.
* The radius of the search is currently clamped to 10m but will eventually be a parameter.
* The radius of the search is currently clamped to 20m but will eventually be a parameter.
* Using this function incurs a one frame script sleep.|
* Using this function incurs a one frame script sleep.|
notes=Using the method incurs a one frame script sleep and the call can be extremely expensive. It is intended to be used in response to a path_update message indicating an inability to reach a requested destination (e.g., because the character or the destination is off the mesh).|
notes=Using the method incurs a one frame script sleep and the call can be extremely expensive. It is intended to be used in response to a path_update message indicating an inability to reach a requested destination (e.g., because the character or the destination is off the mesh).|

Revision as of 16:35, 25 February 2012

Summary

Function: llGetClosestNavPoint( vector point, list options );

The function accepts a point in region-local space (like all the other pathfinding methods) and returns either an empty list or a list containing a single vector which is the closest point on the navmesh to the point provided.

• vector point A point in region-local space.
• list options No options at this time.

Caveats

  • There is no guarantee that a path exists from your current location to the returned point.
  • The radius of the search is currently clamped to 20m but will eventually be a parameter.
  • Using this function incurs a one frame script sleep.
All Issues ~ Search JIRA for related Bugs

Examples

Notes

Using the method incurs a one frame script sleep and the call can be extremely expensive. It is intended to be used in response to a path_update message indicating an inability to reach a requested destination (e.g., because the character or the destination is off the mesh).

Deep Notes

Search JIRA for related Issues

Signature

function void llGetClosestNavPoint( vector point, list options );