Difference between revisions of "LlTeleportAgent"

From Second Life Wiki
Jump to: navigation, search
m
(One intermediate revision by the same user not shown)
Line 12: Line 12:
 
|func_footnote
 
|func_footnote
 
|caveats=
 
|caveats=
 +
* '''This function can only teleport the owner of the object.'''
 
* This function cannot be used in a script in an object attached using [[llAttachToAvatarTemp]].
 
* This function cannot be used in a script in an object attached using [[llAttachToAvatarTemp]].
 
* Sitting avatars cannot be teleported using this function. You must [[llUnSit]] them first.
 
* Sitting avatars cannot be teleported using this function. You must [[llUnSit]] them first.

Revision as of 10:11, 12 July 2012

Emblem-important-red.png Pre-release Documentation Warning!

This function is only available in the RC LeTigre channel. This documentation was written prior to its final release so it may not match the final implementation.

Summary

Function: llTeleportAgent( key avatar, string landmark, vector position, vector look_at );

Requests a teleport of avatar to a landmark stored in the object's inventory. If no landmark is provided (an empty string), the avatar is teleported to the location position in the current region. In either case, the avatar is turned to face the position given by look_at in local coordinates.

• key avatar avatar UUID that is in the same region (the avatar to teleport)
• string landmark a landmark in the inventory of the prim this script is in or an empty string (for teleporting within the same region)
• vector position The position within the local region to teleport the avatar to if no landmark was provided.
• vector look_at The position within the target region that the avatar should be turned to face upon arrival.

To run this function the script must request the PERMISSION_TELEPORT permission with llRequestPermissions and it must be granted by avatar.

Caveats

  • If landmark is not an empty string and...
    • landmark is missing from the prim's inventory or it is not a landmark then it fails silently.
Permissions
  • Once the PERMISSION_TELEPORT permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.
  • This function can only teleport the owner of the object.
  • This function cannot be used in a script in an object attached using llAttachToAvatarTemp.
  • Sitting avatars cannot be teleported using this function. You must llUnSit them first.
All Issues ~ Search JIRA for related Bugs

Examples

Without a landmark in the object's inventory <lsl>key teleportee;

default {

   state_entry()
   {
       llSay(0, "Touch to teleport");
   }
   touch_start(integer total_num)
   {
       teleportee = llDetectedKey(0);
       llRequestPermissions(teleportee, PERMISSION_TELEPORT);
   }
   
   run_time_permissions(integer perm)
   {
       if(PERMISSION_TELEPORT & perm)
       {
           llTeleportAgent(teleportee, "", <13.0, 38.0, 23.5>, <13.0, 12.0, 23.5>);
       }
   }

} </lsl> With a landmark in the objects inventory <lsl> key teleportee;

default {

   state_entry()
   {
       llSay(0, "Touch to teleport");
   }
   touch_start(integer total_num)
   {
       teleportee = llDetectedKey(0);
       llRequestPermissions(teleportee, PERMISSION_TELEPORT);
   }
   
   run_time_permissions(integer perm)
   {
       if(PERMISSION_TELEPORT & perm)
       {
           llTeleportAgent(teleportee, "Experience Tools 1", <0.0, 0.0, 0.0>, <0.0, 0.0, 0.0>);
       }
   }

}

</lsl>

See Also

Events

•  run_time_permissions Permission receiving event

Functions

•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
•  llTeleportAgentGlobalCoords Teleports an agent to a global position.

Articles

•  Script permissions

Deep Notes

Search JIRA for related Issues

Signature

function void llTeleportAgent( key avatar, string landmark, vector position, vector look_at );