OsSetSitActiveRange - Revision history

Manni at 07:04, 6 March 2024

2024-03-06T07:04:11Z

Ferd Frederix: passive voice change to active voice, punctuation.

2020-07-20T04:04:40Z

passive voice change to active voice, punctuation.

Djphil: Add exemple script

2020-02-08T13:36:03Z

Add exemple script

Ubit at 13:48, 25 January 2020

2020-01-25T13:48:58Z

Ubit at 13:47, 25 January 2020

2020-01-25T13:47:31Z

Ubit at 20:18, 23 January 2020

2020-01-23T20:18:50Z

Ubit at 20:15, 23 January 2020

2020-01-23T20:15:35Z

Ubit at 20:14, 23 January 2020

2020-01-23T20:14:28Z

Ubit at 20:13, 23 January 2020

2020-01-23T20:13:05Z

Ubit: Created page with "{{osslfunc |function_syntax=osSetActiveRange(float range) |csharp_syntax= |description= sets a limit on how far a avatar can be to accept a sit request * range > 0: if a avata..."

2020-01-23T20:11:59Z

Created page with "{{osslfunc |function_syntax=osSetActiveRange(float range) |csharp_syntax= |description= sets a limit on how far a avatar can be to accept a sit request * range > 0: if a avata..."

New page

{{osslfunc
|function_syntax=osSetActiveRange(float range)
|csharp_syntax=
|description= sets a limit on how far a avatar can be to accept a sit request
* range > 0: if a avatar if far from the prim by more that 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
|threat_level= none
|permissions= none
|delay=0
|ossl_example=
|additional_info=This function was added in 0.9.2.0
}}

@@ Line 13: / Line 13: @@
 // Example of osSetSitActiveRange
-vector target = <0.0, 0.3, 0.55>;
+vector target = <0.0, 0.3, 0.55>; // Defines the position where avatars will sit
-vector rotate = <0.0, 0.0, 90.0>;
+vector rotate = <0.0, 0.0, 90.0>; // Defines the rotation of the seated avatars
-float active_range = 5.0;
+float active_range = 5.0; // Specifies the range within which avatars are considered active
-key avatar;
+key avatar; // Stores the key of the currently seated avatar
 debug(string name)
+{
-     active_range = osGetSitActiveRange();
+     active_range = osGetSitActiveRange(); // Updates the active range
-     llOwnerSay("active_range for avatar " + name + " is " + (string)active_range);
+     llOwnerSay("active_range for avatar " + name + " is " + (string)active_range); // Outputs debug message
+}
@@ Line 28: / Line 29: @@
      state_entry()
+     {
-         llUnSit(llAvatarOnSitTarget());
+         llUnSit(llAvatarOnSitTarget()); // Ensures no avatar is currently seated
-         llSetClickAction(CLICK_ACTION_SIT);
+         llSetClickAction(CLICK_ACTION_SIT); // Sets click action to trigger sitting behavior
-         llSitTarget(target, llEuler2Rot((rotate * DEG_TO_RAD)));
+         llSitTarget(target, llEuler2Rot((rotate * DEG_TO_RAD))); // Sets the sitting target position and rotation
-         osSetSitActiveRange(active_range);
+         osSetSitActiveRange(active_range); // Sets the active range for avatar sitting
+     }
      changed(integer change)
+     {
-         if (change & CHANGED_LINK)
+         if (change & CHANGED_LINK) // Checks if there's a change in links (i.e., avatar sitting)
+         {
-             key user = llAvatarOnSitTarget();
+             key user = llAvatarOnSitTarget(); // Gets the key of the avatar sitting on the target
-             if (user != NULL_KEY)
+             if (user != NULL_KEY) // If an avatar is sitting on the target
+             {
-                 avatar = user;
+                 avatar = user; // Stores the key of the seated avatar
-                 debug(osKey2Name(avatar));
+                 debug(osKey2Name(avatar)); // Outputs debug message with the name of the seated avatar
+             }
+             else if (user == NULL_KEY) // If no avatar is sitting on the target
              else if (user == NULL_KEY)
+             {
-                 debug(osKey2Name(avatar));
+                 debug(osKey2Name(avatar)); // Outputs debug message with the name of the previously seated avatar
-                 avatar = NULL_KEY;
+                 avatar = NULL_KEY; // Resets the stored avatar key
+             }
+             else // If an unexpected situation occurs
              else
+             {
-                 llResetScript();
+                 llResetScript(); // Resets the script
+             }
+         }

@@ Line 2: / Line 2: @@
 |function_syntax=osSetSitActiveRange(float range)
 |csharp_syntax=
-|description= sets a limit on how far a avatar can be to have a sit request accepted, or disable sits
+|description= sets a limit on how far a avatar can be to have a sit request accepted, or disable sits.
-* range > 0: if a avatar if far from the prim by more than that value, a sit request is silent ignored
+* range > 0:  sit request is silently ignored if a avatar is further than range from the prim.
-* 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: disables this limit. Region default is used. Currently range 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
+* range < 0: sits are disabled. Requests are silently ignored.
-this value is stored on the prim, even if the script is removed
+The range value is stored in the prim, even if the script is removed
 |threat_level= None
 |permissions= true

@@ Line 2: / Line 2: @@
 |function_syntax=osSetSitActiveRange(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
 * 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

@@ Line 2: / Line 2: @@
 |function_syntax=osSetSitActiveRange(float range)
 |csharp_syntax=
-|description= sets a limit on how far a avatar can be to accept a sit request
+|description= sets a limit on how far a avatar can be to have a sit request accepted
 * 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

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

@@ Line 6: / Line 6: @@
 * 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
 |threat_level= none
 |permissions= none