OsReplaceAgentEnvironment - Revision history

Djphil: Small changes in the script

2020-12-21T20:07:14Z

Small changes in the script

Djphil: Small change

2020-12-21T20:05:07Z

Small change

Djphil: Typos

2020-12-21T19:54:26Z

Typos

Djphil: Adding second exemple

2020-12-21T19:51:42Z

Adding second exemple

Djphil: Typo

2020-12-21T19:02:27Z

Typo

Djphil: Add of errors returned

2020-12-21T18:59:05Z

Add of errors returned

Djphil: Ooops

2020-12-16T11:18:30Z

Ooops

Djphil: Small changes in the script

2020-12-16T11:17:13Z

Small changes in the script

Djphil: Add See Also

2020-12-15T17:37:22Z

Add See Also

Djphil: Small changes in the script

2020-12-03T00:02:51Z

Small changes in the script

@@ Line 140: / Line 140: @@
              if (result == -3)
+             {
-                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "The daycycle is not found ...");
+                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "The daycycle asset is not found ...");
+             }

@@ Line 14: / Line 14: @@
   return -1 : Never -1
   return -2 : if no ossl rights
-  return -3 : if daycycle not found
+  return -3 : if daycycle asset not found
   return -4 : if agent not found
   return -5 : if fail to decode daycycle asset

@@ Line 11: / Line 11: @@
 ''' The errors returned are: '''
   return  0 : Never 0 for now
-  return  1 : Daycycle applied with success
+  return  1 : if daycycle applied with success
   return -1 : Never -1
-  return -2 : No ossl rights
+  return -2 : if no ossl rights
-  return -3 : Daycycle not found
+  return -3 : if daycycle not found
-  return -4 : Agent not found
+  return -4 : if agent not found
-  return -5 : Fail to decode daycycle asset
+  return -5 : if fail to decode daycycle asset
 |ossl_example=<source lang="lsl">
 //

@@ Line 11: / Line 11: @@
 ''' The errors returned are: '''
   return  0 : Never 0 for now
-  return  1 : if daycycle applied with success
+  return  1 : Daycycle applied with success
-  return -1 : never -1
+  return -1 : Never -1
-  return -2 : no ossl rights
+  return -2 : No ossl rights
-  return -3 : daycycle not found
+  return -3 : Daycycle not found
-  return -4 : agent not found
+  return -4 : Agent not found
-  return -5 : if fail to decode daycycle asset
+  return -5 : Fail to decode daycycle asset
 |ossl_example=<source lang="lsl">
 //
@@ Line 76: / Line 76: @@
+         {
              llInstantMessage(agentKey, "You need to be in the same region to use this function ...");
+         }
+     }

@@ Line 9: / Line 9: @@
 * if return value is negative, it failed.
 * transition should be the viewer transition time to the new one. May not work on most viewers.
-''' The errors retured are: '''
+''' The errors returned are: '''
   return  0 : Never 0 for now
   return  1 : if daycycle applied with success

@@ Line 36: / Line 36: @@
+         {
              integer result;
              if (switch = !switch)

@@ Line 10: / Line 10: @@
 * transition should be the viewer transition time to the new one. May not work on most viewers.
 |ossl_example=<source lang="lsl">
 //
 // osReplaceAgentEnvironment Script Example
 // Author: djphil
 //
-−
 // Can be asset's name in object's inventory or the asset uuid
-string daycycle_1 = "A-12AM";
+string daycycle_a = "Daycycle_A";
-string daycycle_2 = NULL_KEY;
+string daycycle_b = NULL_KEY;
 integer transition = 3;
 integer switch;
@@ Line 26: / Line 25: @@
      state_entry()
+     {
-         llSay(PUBLIC_CHANNEL, "Touch to see osReplaceAgentEnvironment usage with a transition of " + (string)transition);
+         llSay(PUBLIC_CHANNEL, "Touch to see osReplaceAgentEnvironment usage.");
+     }
-−
      touch_start(integer number)
+     {
          key agentKey = llDetectedKey(0);
-−
          if (llGetAgentSize(agentKey) != ZERO_VECTOR)
+         {
              integer result;
-−
              llRegionSayTo(agentKey, PUBLIC_CHANNEL, "agentKey: " + (string)agentKey);
-−
              if (switch = !switch)
+             {
-                 result = osReplaceAgentEnvironment(agentKey, transition, daycycle_1);
+                 result = osReplaceAgentEnvironment(agentKey, transition, daycycle_a);
-                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "daycycle_1: " + daycycle_1);
+                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "daycycle_a: " + daycycle_a);
+             }
-−
              else
+             {
-                 result = osReplaceAgentEnvironment(agentKey, transition, daycycle_2);
+                 result = osReplaceAgentEnvironment(agentKey, transition, daycycle_b);
-                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "daycycle_2: " + daycycle_2);
+                 llRegionSayTo(agentKey, PUBLIC_CHANNEL, "daycycle_b: " + daycycle_b);
+             }
-−
-             if (result == 1)
+             if (daycycle_a == "" || daycycle_a == NULL_KEY || daycycle_b == "" || daycycle_b == NULL_KEY)
+             {
                  llRegionSayTo(agentKey, PUBLIC_CHANNEL, "Agent environment replaced with success!");
+             }
-−
-             else
+             else if (result < 0)
+             {
                  llRegionSayTo(agentKey, PUBLIC_CHANNEL, "Agent environment replaced without success!");
+             }
+         }
-−
          else
+         {

← Older revision		Revision as of 17:37, 15 December 2020
Line 71:		Line 71:
	\|additional_info=This function was added in 0.9.2		\|additional_info=This function was added in 0.9.2
	}}		}}
		+	== See Also ==
		+	* [[osReplaceAgentEnvironment]]
		+	* [[osReplaceParcelEnvironment]]
		+	* [[osReplaceRegionEnvironment]]
		+	* [[osResetEnvironment]]