Difference between revisions of "LlGetClosestNavPoint"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
m |
||
| Line 1: | Line 1: | ||
{{Pathfinding alpha}} | {{Pathfinding alpha}} | ||
{{LSL_Function| | {{LSL_Function| | ||
inject-2={{ | inject-2={{LSL Function/position|point|region=*}}| | ||
func=llGetClosestNavPoint| | func=llGetClosestNavPoint| | ||
func_desc= | func_desc=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.| | ||
p1_type=vector| | p1_type=vector| | ||
p1_name=point| | p1_name=point| | ||
p2_type=list| | p2_type=list| | ||
p2_name=options| | p2_name=options| | ||
p2_desc= | p2_desc=No options at this time.| | ||
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 20m but will eventually be a parameter. | |||
* 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_functions= | also_functions= | ||
Revision as of 22:13, 19 June 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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.
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).
See Also
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function void llGetClosestNavPoint( vector point, list options ); |