OsTeleportObject

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (XEngine to OSSL)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
 
|threat_level=Severe
 
|threat_level=Severe
||permissions=${XEngine|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
+
||permissions=${OSSL|osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
 
|delay=0
 
|delay=0
 
|function_syntax=integer osTeleportObject(key objectID, vector targetPos, rotation rot, integer flags)
 
|function_syntax=integer osTeleportObject(key objectID, vector targetPos, rotation rot, integer flags)
Line 19: Line 19:
 
         vector target =<873.911926, 879.844910, 21.332354>;   
 
         vector target =<873.911926, 879.844910, 21.332354>;   
 
         rotation rot =<0,0,0.707,.707>;
 
         rotation rot =<0,0,0.707,.707>;
         osObjectTeleport(llGetKey(),target,rot,1);
+
         osTeleportObject(llGetKey(),target,rot,1);
 
     }
 
     }
 
}
 
}
Line 34: Line 34:
 
===== Flags: =====
 
===== Flags: =====
 
* OSTPOBJ_NONE it is just 0
 
* OSTPOBJ_NONE it is just 0
* OSTPOBJ_STOPATTARRGET object is stopped at destination
+
* OSTPOBJ_STOPATTARGET object is stopped at destination
 
* OSTPOBJ_STOPONFAIL stops at start point if tp fails (still does nothing)
 
* 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
 
* OSTPOBJ_SETROT the rotation is the final object rotation, otherwise is a added rotation
  
|additional_info=returns a integer error code:
+
 
 +
|additional_info=This function was added in 0.9.0.1
 +
returns a integer error code:
 
* negative the teleport failed
 
* negative the teleport failed
 
* Zero means that a teleport to another region was started. result needs to be checked by other means (?)
 
* Zero means that a teleport to another region was started. result needs to be checked by other means (?)
Line 65: Line 67:
 
* target location parcel must have enought free prims capacity for the linkset prims
 
* 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
 
* 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
+
* 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
 
* the object can not be selected at tp time
 
+
}}
|additional_info=This function was added in 0.9.0.1}}
+

Latest revision as of 07:34, 7 November 2019

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