OsTeleportOwner

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
'''Syntax:'''
+
{|  width="100%" style="border: thin solid black"
 +
| colspan="2" align="center" style=background:orange | '''{{SUBPAGENAME}}'''
 +
|- valign="top"
 +
|'''Threat Level''' || None
  
'''osTeleportOwner(string destinationTarget, vector position, vector lookAt)''' <br />
+
|- valign="top"
'''osTeleportOwner(integer regionX, integer regionY, vector position, vector lookAt)''' <br />
+
|'''Function Syntax''' || <source lang="lsl">
'''osTeleportOwner(vector position, vector lookAt)'''
+
osTeleportOwner(string destinationTarget, vector position, vector lookAt)
 
+
osTeleportOwner(integer regionX, integer regionY, vector position, vector lookAt)
'''Returns:'''
+
osTeleportOwner(vector position, vector lookAt)
 
+
</source>
Nothing
+
|- valign="top"
 
+
|'''Example(s)||<source lang="lsl">// Teleporting HUD script
'''Threat level:'''
+
 
+
None
+
 
+
'''Description:'''
+
 
+
Teleports the owner of the object containing the script to the specified location. The first variant is able to teleport to any addressable region, including [[hypergrid]] destinations. The second variant teleports to a region in the local grid; the region coordinates are specified as region cells (not as global coordinates based on meters). The third variant teleports within the current region.
+
 
+
These functions have a [[threat level]] of ''None''. Also see [[osTeleportAgent]].
+
 
+
These functions have been added to OpenSim with commit r/14355 on November 16, 2010.
+
 
+
'''Example:'''
+
<source lang="lsl">// Teleporting HUD script
+
 
// Put this script into a prim and attach it as a HUD
 
// Put this script into a prim and attach it as a HUD
  
Line 59: Line 48:
 
}</source>
 
}</source>
  
 +
|}
 +
 +
Teleports the owner of the object containing the script to the specified location. The first variant is able to teleport to any addressable region, including [[hypergrid]] destinations. The second variant teleports to a region in the local grid; the region coordinates are specified as region cells (not as global coordinates based on meters). The third variant teleports within the current region.
 +
 +
These functions have been added to OpenSim with commit r/14355 on November 16, 2010.
 +
 +
See also  [[osTeleportAgent]].
  
[[Category:OSSL]]
+
[[Category:OSSL Functions]]
[[Category:Scripting]]
+
[[Category:Scripts]]
+

Revision as of 12:31, 11 June 2011

OsTeleportOwner
Threat Level None
Function Syntax
osTeleportOwner(string destinationTarget, vector position, vector lookAt)
osTeleportOwner(integer regionX, integer regionY, vector position, vector lookAt)
osTeleportOwner(vector position, vector lookAt)
Example(s)
// Teleporting HUD script
// Put this script into a prim and attach it as a HUD
 
list Destinations = [ "Welcome Area",
    "hg.osgrid.org:80",
    "ucigrid00.nacs.uci.edu:8002:Gateway 3000",
    "ucigrid00.nacs.uci.edu:8002:Gateway 7000" ];
list RegionNames;
 
default {
    state_entry() {
        // Derive region names from destinations
        integer i;
        for (i = 0; i < llGetListLength(Destinations); ++i) {
            string destination = llList2String(Destinations, i);
            list parts = llParseString2List(destination, [":"], []);
            integer numParts = llGetListLength(parts);
            if (numParts > 2)       // Hypergrid address with region name
                RegionNames += [ llList2String(parts, 2) ];
            else if (numParts == 2) // Hypergrid address without region
                RegionNames += [ llList2String(parts, 0) ];
            else                    // Destination in the local grid
                RegionNames += destination;
        }
    }
    touch_start(integer number) {
        llListen(-1234, "", llGetOwner(), "");
        llDialog(llDetectedKey(0), "Choose a destination:", RegionNames, -1234);
    }
    listen(integer channel, string name, key id, string message) {
        integer index = llListFindList(RegionNames, [ message ]);
        string destination = llList2String(Destinations, index);
        llOwnerSay("Teleporting to " + destination);
        osTeleportOwner(destination, <128, 128, 20>, ZERO_VECTOR);
    }
}

Teleports the owner of the object containing the script to the specified location. The first variant is able to teleport to any addressable region, including hypergrid destinations. The second variant teleports to a region in the local grid; the region coordinates are specified as region cells (not as global coordinates based on meters). The third variant teleports within the current region.

These functions have been added to OpenSim with commit r/14355 on November 16, 2010.

See also osTeleportAgent.

Personal tools
General
About This Wiki