OsTeleportObject

Revision as of 16:10, 17 April 2018

Home

Download

News

Support

Admin

Dev

Screen Shots

Grid List

Bugs

Languages:

English

integer osTeleportObject(key objectUUID, vector targetPos, rotation rot, int flags)
... Arguments: objectUUID the id of the linkset to teleport targetPos target position rot a rotation. flags Flags: OSTPOBJ_NONE it is just 0 OSTPOBJ_STOPATTARRGET object is stopped at destination OSTPOBJ_STOPONFAIL stops at start point if tp fails (still does nothing) OSTPOBJ_SETROT the rotation is the final object rotation, otherwise is a added rotation
Threat Level	Severe
Permissions	${XEngine\|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
Extra Delay	0 seconds
Example(s)
// Example of osTeleportObject default { state_entry() { llSay(0, "Script running"); } touch_start(integer num) { // target position in region local coords vector target =<873.911926, 879.844910, 21.332354>; rotation rot =<0,0,0.707,.707>; osObjectTeleport(llGetKey(),target,rot,1); } }
Notes
returns a integer error code: negative the teleport failed Zero means that a teleport to another region was started. result needs to be checked by other means (?) 1 did a local teleport Restrictions: if object has scripts, owner must have rights to run scripts on target location object owner must have rights to enter ojects on target location target location parcel must have enought free prims capacity for the linkset prims all avatars siting on the object must have access to target location has a cool down time. retries before expire reset it, and tp is ignored with error -2 the object can not be selected at tp time

@@ Line 12: / Line 12: @@
      state_entry()
      {
-         ...
+       llSay(0, "Script running");
+    }
+    touch_start(integer num)
+    {
+         // target position in region local coords
+        vector target =<873.911926, 879.844910, 21.332354>;
+        rotation rot =<0,0,0.707,.707>;
+        osObjectTeleport(llGetKey(),target,rot,1);
      }
 }