llGetClosestNavPoint

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetClosestNavPoint

llGetClosestNavPoint

Summary

Function: llGetClosestNavPoint( vector point, list options );

?	Function ID
1	Forced Delay
	Energy

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.

Options	V	Parameters	Default	Description
[ GCNP_RADIUS ]	0	[ float distance ]	[ 20.0 ]	Limits how far out to search for a navigation point.
[ GCNP_STATIC ]	1	[ integer use_static_mesh ]	[ FALSE ]	Specifies whether the test should use the static or dynamic nav mesh. In the static case, all dynamic obstacles are ignored.
[ CHARACTER_TYPE ]	6	[ integer type ]	[ CHARACTER_TYPE_NONE ]	Filters nav points by eliminating nav mesh faces which are 0% walkable for the specified character type. In the default CHARACTER_TYPE_NONE case, all nav mesh faces are included.

Caveats

• This function causes the script to sleep for 1 frame.
• There is no guarantee that a path exists from your current location to the returned point.

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).

See Also

Events

• path_update

Functions

• llCreateCharacter
• llDeleteCharacter
• llEvade
• llExecCharacterCmd
• llGetClosestNavPoint
• llFleeFrom
• llNavigateTo
• llPatrolPoints
• llPursue
• llUpdateCharacter
• llWanderWithin

Deep Notes

Search JIRA for related Issues

Signature
function void llGetClosestNavPoint( vector point, list options );