OsTeleportObject

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
Line 27: Line 27:
 
===== Arguments: =====
 
===== Arguments: =====
 
* objectUUID the id of the linkset to teleport
 
* objectUUID the id of the linkset to teleport
* targetPos target position
+
* targetPos target position in region local coords
 +
 
 
* rot a rotation.
 
* rot a rotation.
 
* flags
 
* flags
Line 49: Line 50:
 
* has a cool down time. retries before expire reset it, and tp is ignored with error -2
 
* 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
 
* the object can not be selected at tp time
 +
 +
make sure there is enough clear space on target position for the object to arrive
 
|
 
|
 
}}
 
}}

Revision as of 17:12, 17 April 2018

integer osTeleportObject(key objectUUID, vector targetPos, rotation rot, int flags)
...
Arguments:
  • objectUUID the id of the linkset to teleport
  • targetPos target position in region local coords
  • 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

make sure there is enough clear space on target position for the object to arrive

Personal tools
General
About This Wiki