User:haravikk Mistral/LlTeleportAgent

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/ja 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

TeleportAgent

User:llTeleportAgent

	LSL Feature Request
	The described function does not exist. This article is a feature request.

Summary

Function: llTeleportAgent( key avatar, string region, vector pos, vector look_at );

0.0	Forced Delay
10.0	Energy

Requests a teleport of avatar to location pos within region, turning the avatar to face the position given by look_at. Providing an empty string for region requests a local teleport, and is identical to explicitly providing the name of the current region.

• key	avatar	–	The key of the avatar for which to request a teleport.
• string	region	–	The region to teleport the avatar to. Provide with an empty string, or the name of the current region, for a local teleport.
• vector	pos	–	The position within the region to teleport the avatar to. If the value of the X or Y component is less than 0.0 or greater than or equal to 256.0, then a local teleport will become a global one.
• vector	look_at	–	The position within the region that the avatar should be turned to face upon arrival.

Caveats

• This function sends requests to an agent's viewer, compatible with calls to llMapDestination() in unsupported viewers.
• By default, viewers that permit automatic teleportation will do so if:
  • The scripted object is worn by the avatar being teleported.
  • The scripted object belongs to the land-owner of the parcel that the avatar is currently within, and the requested teleport is a local one.
• Other requests, or all requests for viewers that have disabled automatic teleportation, will trigger a dialogue giving details of the teleport request.
• This function is throttled at 10 requests per every 30 seconds by the simulator, and 1 per every 20 seconds in supported viewers.

Examples

<lsl>default {

   key teleportedAgent;

   touch_start(integer x) {
       llTeleportAgent(teleportedAgent = llDetectedKey(0), "", <128.0, 128.0, 25.0>, <129.0, 128.0, 25.0>);
       llSetTimerEvent(30.0);
   }

   timer() {
       // Is the teleported avatar still nearby?
       vector pos = llList2Vector(llGetObjectDetails(teleportedAgent, [OBJECT_POS]), 0);

if ((pos == ZERO_VECTOR)

Notes

This would be extremely useful in complex builds such as Stargates, HUDS and other teleportation creations.

• look_at is included to match llMapDestination's still pending look_at functionalty (see VWR-23580).
• See SVC-212 for the JIRA listing for this function.

Deep Notes

Signature
//function void llTeleportAgent( key avatar, string region, vector pos, vector look_at );