Difference between revisions of "LlTeleportAgent"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Wolfie Waves (talk | contribs) m (Added the main JIRA link that relates to this function.) |
|||
| Line 1: | Line 1: | ||
{{LSL_Function|func_id|mode=request|func_sleep=0.1|func_energy=10.0|func=llTeleportAgent|sort=TeleportAgent|p1_type=key|p1_name=id|p2_type=string|p2_name=simname|p3_type=vector|p3_name=pos|p4_type=vector|p4_name=look_at|func_desc=Teleports agent id to location pos.|return_text|spec|caveats=Agent must be the script owner or must be on script owner's land (or the script owner is a member of the land group for group-owned land). Repeated teleports within a short period should be suppressed.|examples|helpers|related|also|notes=This would be extremely useful in complex builds such as Stargates, HUDS and other teleportation creations. NOTE: look_at is included to match llMapDestination's look_at possible future functionality, which currently does nothing. | {{LSL_Function | ||
* See | |func_id|mode=request | ||
|func_sleep=0.1 | |||
|func_energy=10.0 | |||
|func=llTeleportAgent | |||
|sort=TeleportAgent | |||
|p1_type=key|p1_name=id | |||
|p2_type=string|p2_name=simname | |||
|p3_type=vector|p3_name=pos | |||
|p4_type=vector|p4_name=look_at | |||
|func_desc=Teleports agent id to location pos. | |||
|return_text | |||
|spec | |||
|caveats=Agent must be the script owner or must be on script owner's land (or the script owner is a member of the land group for group-owned land). Repeated teleports within a short period should be suppressed. | |||
|examples | |||
|helpers | |||
|related | |||
|also | |||
|notes=This would be extremely useful in complex builds such as Stargates, HUDS and other teleportation creations. NOTE: look_at is included to match llMapDestination's look_at possible future functionality, which currently does nothing. | |||
* See {{JIRA|SVC-212}} for the JIRA listing for this function. | |||
}} | |||
==Notes== | ==Notes== | ||
* Target agent should ''ignore'' subsequent calls to llTeleportAgent within a modest time limit (5 seconds, say), to prevent it from being used for a repeat-teleport trap. This timeout should be per-agent, applied to any script attempting to teleport the agent using this call within that period, and the script need not be informed. | * Target agent should ''ignore'' subsequent calls to llTeleportAgent within a modest time limit (5 seconds, say), to prevent it from being used for a repeat-teleport trap. This timeout should be per-agent, applied to any script attempting to teleport the agent using this call within that period, and the script need not be informed. | ||
* If the sim name is empty, target is the same sim, and the "teleporting" screen is not interposed (ie, it's equivalent to WarpMove, except without sitting on a prim). | * If the sim name is empty, target is the same sim, and the "teleporting" screen is not interposed (ie, it's equivalent to WarpMove, except without sitting on a prim). | ||
Revision as of 05:19, 3 April 2009
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
|
LSL Feature Request |
| The described function does not exist. This article is a feature request. |
Summary
Function: llTeleportAgent( key id, string simname, vector pos, vector look_at );| REQUEST | Function ID |
| 0.1 | Forced Delay |
| 10.0 | Energy |
Teleports agent id to location pos.
| • key | id | |||
| • string | simname | |||
| • vector | pos | |||
| • vector | look_at |
Caveats
- This function causes the script to sleep for 0.1 seconds.Agent must be the script owner or must be on script owner's land (or the script owner is a member of the land group for group-owned land). Repeated teleports within a short period should be suppressed.
Examples
Notes
This would be extremely useful in complex builds such as Stargates, HUDS and other teleportation creations. NOTE: look_at is included to match llMapDestination's look_at possible future functionality, which currently does nothing.
- See SVC-212 for the JIRA listing for this function.
Deep Notes
Search JIRA for related Issues
Signature |
|---|
//function void llTeleportAgent( key id, string simname, vector pos, vector look_at ); |
Notes
- Target agent should ignore subsequent calls to llTeleportAgent within a modest time limit (5 seconds, say), to prevent it from being used for a repeat-teleport trap. This timeout should be per-agent, applied to any script attempting to teleport the agent using this call within that period, and the script need not be informed.
- If the sim name is empty, target is the same sim, and the "teleporting" screen is not interposed (ie, it's equivalent to WarpMove, except without sitting on a prim).