OsTeleportObject
From OpenSimulator
JeffKelley (Talk | contribs) m (osObjectTeleport -> osTeleportObject) |
BillBlight (Talk | contribs) |
||
| Line 38: | Line 38: | ||
* 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 67: | Line 69: | ||
* 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 | ||
| − | + | }} | |
| − | + | ||
Revision as of 12:13, 31 August 2019
 |
Languages: |
|
integer osTeleportObject(key objectID, vector targetPos, rotation rot, integer flags)
| |
...
Arguments:
Flags:
| |
| 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>; osTeleportObject(llGetKey(),target,rot,1); } } | |
| Notes | |
| This function was added in 0.9.0.1
returns a integer error code:
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:
| |
