OsLocalTeleportAgent
From OpenSimulator
(Difference between revisions)
| Line 35: | Line 35: | ||
|description=Teleports an agent to the specified location within same region. | |description=Teleports an agent to the specified location within same region. | ||
For osLocalTeleportAgent() to work, the owner of the prim containing the script must also be owner of the parcel where the avatar is currently on. The Avatar must have rights to enter the target position. If this isn't the case then the function fails silently. Flags is a bit field:<br> | For osLocalTeleportAgent() to work, the owner of the prim containing the script must also be owner of the parcel where the avatar is currently on. The Avatar must have rights to enter the target position. If this isn't the case then the function fails silently. Flags is a bit field:<br> | ||
| − | bit 0: use newVelocity | + | bit 0 (mask 1): use newVelocity<br> |
| − | bit 1: use newLookAt <br> | + | bit 1 (mask 2): use newLookAt<br> |
| − | bit 2: align lookat to velocity if not zero<br> | + | bit 2 (mask 4): align lookat to velocity if not zero<br> |
| − | bit 3: fly<br> | + | bit 3 (mask 8): fly<br> |
| − | bit 4: do not fly<br> | + | bit 4 (mask 16): do not fly<br> |
<br> | <br> | ||
if both bits 1 and 2 are set bit 2 is ignored<br> | if both bits 1 and 2 are set bit 2 is ignored<br> | ||
Revision as of 13:24, 1 May 2019
 |
Languages: |
|
void osLocalTeleportAgent(key agent, vector newPosition, vector newVelocity, vector newLookat, integer flags)
| |
| Teleports an agent to the specified location within same region.
For osLocalTeleportAgent() to work, the owner of the prim containing the script must also be owner of the parcel where the avatar is currently on. The Avatar must have rights to enter the target position. If this isn't the case then the function fails silently. Flags is a bit field: | |
| Threat Level | Severe |
| Permissions | ${XEngine|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER |
| Extra Delay | 5 seconds |
| Example(s) | |
vector LandingPoint = <128,128,50>; // X,Y,Z landing point for avatar to arrive at vector LookAt = <1,1,1>; // which way they look at when arriving // default { on_rez(integer start_param) { llResetScript(); } changed(integer change) // something changed, take action { if(change & CHANGED_OWNER) llResetScript(); else if (change & 256) // that bit is set during a region restart llResetScript(); } state_entry() { llWhisper(0, "OS Teleportal Active"); } touch_start(integer num_detected) { key avatar = llDetectedKey(0); llInstantMessage(avatar, "Teleporting you to : " + (string)LandingPoint); osLocalTeleportAgent(avatar, LandingPoint, ZEROVECTOR, <0,1,0>, 2); } } | |
