llRotateAgent

From Second Life Wiki
Revision as of 12:38, 21 March 2007 by GC Continental (talk | contribs)
Jump to navigation Jump to search
Emblem-important-yellow.png LSL Feature Request
The described function does not exist. This article is a feature request.

Summary

Function: llRotateAgent( vector direction );
0.2 Forced Delay
10.0 Energy

Rotate owner to point toward direction.

• vector direction

Caveats

  • This function causes the script to sleep for 0.2 seconds.

Examples

vector position_to_point_at;
vector my_pos;
vector direction;

position_to_point_at = [get position of some object];
my_pos = llGetPos();
direction = position_to_point_at - my_pos;

llRotateAgent(direction);

Notes

This should be called from within an attachment and from no other place, and only with PERMISSION_TRIGGER_ANIMATION set. Ideally it would throw out the Z component of the direction vector. Since the old llPointAt() function is deprecated and can't be re-enabled by the community until the server code is opened up, I wanted to propose that LL add a function with this prototype. This should be a one-shot function that does not hold the avatar in the specified direction permanently, but works once and once only.

Animations can not duplicate this functionality, as when an animation is complete the avatar returns to its previous position and orientation.
----
It isn't that it has been deprecated, it just was never enabled. I should probably append that to the function description.

Deep Notes

Signature

//function void llRotateAgent( vector direction );