OsSetLinkSitActiveRange - Revision history

Manni at 06:53, 6 March 2024

2024-03-06T06:53:30Z

Djphil: Add exemple script

2020-02-08T13:39:19Z

Add exemple script

Ubit at 13:49, 25 January 2020

2020-01-25T13:49:31Z

Ubit at 13:47, 25 January 2020

2020-01-25T13:47:04Z

Ubit: Created page with "{{osslfunc |function_syntax=osSetLinkSitActiveRange(integer linkNumber, float range) |csharp_syntax= |description= sets a limit on how far a avatar can be to accept a sit requ..."

2020-01-25T13:44:47Z

Created page with "{{osslfunc |function_syntax=osSetLinkSitActiveRange(integer linkNumber, float range) |csharp_syntax= |description= sets a limit on how far a avatar can be to accept a sit requ..."

New page

{{osslfunc
|function_syntax=osSetLinkSitActiveRange(integer linkNumber, float range)
|csharp_syntax=
|description= sets a limit on how far a avatar can be to accept a sit request
* linkNumber is link number of the prim to change or one of LINK_SET,LINK_ROOT, LINK_ALL_OTHERS,LINK_ALL_CHILDREN or LINK_THIS
* range > 0: if a avatar if far from the prim by more than that value, a sit request is silent ignored
* range == 0: disables this limit. Region default is used. Current that is unlimited if a sit target is set or physics can sit the avatar, otherwise 10m
* range < 0: sits are disabled. Requests are silently ignored
this value is stored on the prim, even if the script is removed
|threat_level= None
|permissions= true
|delay=0
|ossl_example=
|additional_info=This function was added in 0.9.2.0
}}

@@ Line 14: / Line 14: @@
 // Example of osSetLinkSitActiveRange
-vector target = <0.0, 0.3, 0.55>;
+vector target = <0.0, 0.3, 0.55>;  // Target position where avatars will sit
-vector rotate = <0.0, 0.0, 90.0>;
+vector rotate = <0.0, 0.0, 90.0>;   // Rotation of the sitting avatar
-float active_link_range = 5.0;
+float active_link_range = 5.0;     // Initial active link range
-integer link = 2;
+integer link = 2;                  // Link number of the prim
-key avatar;
+key avatar;                        // Key of the avatar currently sitting
 debug(string name)
+{
@@ Line 30: / Line 31: @@
      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));
+                 debug(osKey2Name(avatar)); // Debug and display active link range
+             }
+            // If no avatar is sitting on the prim
              else if (user == NULL_KEY)
+             {
-                 debug(osKey2Name(avatar));
+                 debug(osKey2Name(avatar)); // Debug and display active link range
                  avatar = NULL_KEY;
+             }
+            // Reset the script if an unexpected condition occurs
              else
+             {

@@ Line 11: / Line 11: @@
 |permissions= true
 |delay=0
-|ossl_example=
+|ossl_example=<source lang="lsl">
 |additional_info=This function was added in 0.9.2.0
 }}

@@ Line 2: / Line 2: @@
 |function_syntax=osSetLinkSitActiveRange(integer linkNumber, float range)
 |csharp_syntax=
-|description= sets a limit on how far a avatar can be to have a sit request accepted
+|description= sets a limit on how far a avatar can be to have a sit request accepted, or disable sits
 * linkNumber is link number of the prim to change or one of LINK_SET,LINK_ROOT, LINK_ALL_OTHERS,LINK_ALL_CHILDREN or LINK_THIS
 * range > 0: if a avatar if far from the prim by more than that value, a sit request is silent ignored