OsTeleportObject

From OpenSimulator

Revision as of 17:12, 17 April 2018 by Ubit (Talk | contribs)

Jump to: navigation, search
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