Difference between revisions of "LlGetClosestNavPoint"

From Second Life Wiki
Jump to navigation Jump to search
(Created page with "{{Pathfinding alpha}} {{LSL_Function| func=llGetClosestNavPoint| func_desc=The function accepts a point in region-local space (like all the other pathfinding methods) and returns…")
 
Line 14: Line 14:
* 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).|
also_events=[[path_update]]
also_functions=
* [[llCreateCharacter]]
* [[llDeleteCharacter]]
* [[llEvade]]
* [[llExecPathingCmd]]
* [[llGetClosestNavPoint]]
* [[llFleeFrom]]
* [[llNavigateTo]]
* [[llPatrolPoints]]
* [[llPursue]]
* [[llUpdateCharacter]]
* [[llWanderWithin]]|
also_events=
* [[path_update]]
}}
}}

Revision as of 12:53, 14 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 10m but will eventually be a parameter.
  • Using this function incurs a one frame script sleep.

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

Signature

function void llGetClosestNavPoint( vector point, list options );