llRotateAgent

From Second Life Wiki
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 );
1.0 Forced Delay
10.0 Energy

Rotate owner to point toward direction.

• vector direction

Caveats

  • This function causes the script to sleep for 1.0 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 was never enabled in production versions of the server, and can't be 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.

The sleep caveat is to prohibit malicious AO makers from spinning avatars so fast that it makes RL people dizzy.
----
It isn't that it has been deprecated, it just was never enabled. I should probably append that to the function description.
----
No need, I just added that. It's listed as deprecated in all of the documentation so that's why I originally said so here. (and I really *must* learn to use preview...

Deep Notes

Signature

//function void llRotateAgent( vector direction );