llPatrolPoints

From Second Life Wiki
Revision as of 13:54, 16 February 2012 by Jeremy Linden (talk | contribs)
Jump to navigation Jump to search

Summary

Function: llPatrolPoints( list patrolPoints, list options );

Sets the object patrolling between the points specified in patrolPoints.

• list patrolPoints A list of vectors for the character to travel through sequentially. The list must contain at least two entries.
• list options No options available at this time.

The list patrolPoints is a list of vectors defining the patrol path.

Caveats

  • Must use llCreateCharacter or script won't compile
  • Vertical positions specified for any vectors should be chosen to be as close as possible to the actual height of the terrain requested. Large difference between the provided vertical position and the actual terrain/object will result in failure of the behavior.
  • The patrolPoints list requires a minimum of two entries.
  • If a vector in the list is outside the nav volume (e.g.: too high,) it will be ignored.

Examples

<lsl> default {

   state_entry()
   {
       llCreateCharacter([CHARACTER_DESIRED_SPEED, 50.0]);
   }
   touch_start(integer total_number)
   {
       list points = [llGetPos() + <5,0,0>, llGetPos() - <5,0,0>];
       llPatrolPoints(points, []);
   }

}

</lsl>

Deep Notes

Signature

function void llPatrolPoints( list patrolPoints, list options );