OsTeleportObject

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Created page with "{{osslfunc |threat_level=Severe |function_syntax=integer osTeleportObject(key objectUUID, vector targetPos, rotation rot, int flags) |csharp_syntax= |ossl_example=<source lang...")
 
m (Added permissions and delay information)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
 
|threat_level=Severe
 
|threat_level=Severe
 +
||permissions=${XEngine&#124;osslParcelO}ESTATE_MANAGER,ESTATE_OWNER
 +
|delay=0
 
|function_syntax=integer osTeleportObject(key objectUUID, vector targetPos, rotation rot, int flags)
 
|function_syntax=integer osTeleportObject(key objectUUID, vector targetPos, rotation rot, int flags)
 
|csharp_syntax=
 
|csharp_syntax=

Revision as of 12:42, 25 October 2017

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()
    {
        ...
    }
}
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
Personal tools
General
About This Wiki