OsTeleportObject

From OpenSimulator

Jump to: navigation, search
integer osTeleportObject(key objectID, vector targetPos, rotation rot, integer flags)
...
Arguments:
  • objectID 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_STOPATTARGET 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 ${OSSL|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>;
        osTeleportObject(llGetKey(),target,rot,1);
    }
}
Notes
This function was added in 0.9.0.1

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

This can do region crossings if the target position is on another region.

Since target position is in start region local coords, some simple math is needed

- on the target region, use llgetregioncorner to get its global coords - add to that vector the target position you want on that region local coords

- on the start region use llgetregioncorner to get its global coords - subtract that vector from the previus one. - result is the needed value for target position

you may notice that this may work also on regions that are far apart.

but since it uses normal regions crossing code the operation is not pretty to see on viewer of sitting avatars, so do avoid it

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

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 (1 second), retries before it expires or a reset, tp is ignored with error -2
  • the object can not be selected at tp time
Personal tools
General
About This Wiki