OsGetLinkSitActiveRange
From OpenSimulator
(Difference between revisions)
(Created page with "{{osslfunc |function_syntax=float osGetSitActiveRange(integer linkNumber) |csharp_syntax= |description= returns the sit active range of the selected prim, see [[osSetSitActive...") |
|||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{osslfunc | {{osslfunc | ||
| − | |function_syntax=float | + | |function_syntax=float osGetLinkSitActiveRange(integer linkNumber) |
| − | + | |description= returns the sit active range of the selected prim, see [[osSetLinkSitActiveRange]] | |
| − | |description= returns the sit active range of the selected prim, see [[ | + | |
* linkNumber: the link number of the prim, LINK_THIS or LINK_ROOT | * linkNumber: the link number of the prim, LINK_THIS or LINK_ROOT | ||
* range > 0: if a avatar if far from the prim by more than that value, a sit request is silent ignored | * range > 0: if a avatar if far from the prim by more than that value, a sit request is silent ignored | ||
| Line 12: | Line 11: | ||
|permissions= true | |permissions= true | ||
|delay=0 | |delay=0 | ||
| − | |ossl_example= | + | |ossl_example=<source lang="lsl"> |
| + | // Example of osGetLinkSitActiveRange | ||
| + | |||
| + | vector target = <0.0, 0.3, 0.55>; | ||
| + | vector rotate = <0.0, 0.0, 90.0>; | ||
| + | float active_link_range = 5.0; | ||
| + | integer link = 2; | ||
| + | key avatar; | ||
| + | |||
| + | debug(string name) | ||
| + | { | ||
| + | active_link_range = osGetLinkSitActiveRange(link); | ||
| + | llOwnerSay("active_link_range for avatar " + name + " is " + (string)active_link_range); | ||
| + | } | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | llUnSit(llAvatarOnSitTarget()); | ||
| + | llSetClickAction(CLICK_ACTION_SIT); | ||
| + | llLinkSitTarget(link, target, llEuler2Rot((rotate * DEG_TO_RAD))); | ||
| + | osSetLinkSitActiveRange(link, active_link_range); | ||
| + | } | ||
| + | |||
| + | changed(integer change) | ||
| + | { | ||
| + | if (change & CHANGED_LINK) | ||
| + | { | ||
| + | key user = llAvatarOnSitTarget(); | ||
| + | |||
| + | if (user != NULL_KEY) | ||
| + | { | ||
| + | avatar = user; | ||
| + | debug(osKey2Name(avatar)); | ||
| + | } | ||
| + | |||
| + | else if (user == NULL_KEY) | ||
| + | { | ||
| + | debug(osKey2Name(avatar)); | ||
| + | avatar = NULL_KEY; | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llResetScript(); | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
|additional_info=This function was added in 0.9.2.0 | |additional_info=This function was added in 0.9.2.0 | ||
}} | }} | ||
Latest revision as of 15:32, 3 March 2020
 |
Languages: |
|
float osGetLinkSitActiveRange(integer linkNumber)
| |
returns the sit active range of the selected prim, see osSetLinkSitActiveRange
if link number is invalid it returns -2147483648 (int min value) | |
| Threat Level | None |
| Permissions | Use of this function is always allowed by default |
| Extra Delay | 0 seconds |
| Example(s) | |
// Example of osGetLinkSitActiveRange vector target = <0.0, 0.3, 0.55>; vector rotate = <0.0, 0.0, 90.0>; float active_link_range = 5.0; integer link = 2; key avatar; debug(string name) { active_link_range = osGetLinkSitActiveRange(link); llOwnerSay("active_link_range for avatar " + name + " is " + (string)active_link_range); } default { state_entry() { llUnSit(llAvatarOnSitTarget()); llSetClickAction(CLICK_ACTION_SIT); llLinkSitTarget(link, target, llEuler2Rot((rotate * DEG_TO_RAD))); osSetLinkSitActiveRange(link, active_link_range); } changed(integer change) { if (change & CHANGED_LINK) { key user = llAvatarOnSitTarget(); if (user != NULL_KEY) { avatar = user; debug(osKey2Name(avatar)); } else if (user == NULL_KEY) { debug(osKey2Name(avatar)); avatar = NULL_KEY; } else { llResetScript(); } } } } | |
| Notes | |
| This function was added in 0.9.2.0 | |
