OsResetEnvironment
From OpenSimulator
(Difference between revisions)
m (Small changes in the script) |
(Adding second exemple) |
||
| (3 intermediate revisions by one user not shown) | |||
| Line 7: | Line 7: | ||
* if ParcelOrRegion == 1 parcel environment is removed, region will be used, else region environment is set to the default. | * if ParcelOrRegion == 1 parcel environment is removed, region will be used, else region environment is set to the default. | ||
* transition should be the viewer transition time to the new one. May not work on most viewers. | * transition should be the viewer transition time to the new one. May not work on most viewers. | ||
| − | if return is negative the operation failed. | + | * if return is negative the operation failed. |
| + | ''' The errors returned on region are: ''' | ||
| + | return 0 : never 0 for now | ||
| + | return 1 : if daycycle applied with success | ||
| + | return -1 : never -1, it is on parcel only | ||
| + | return -2 : never -2, it is on parcel only | ||
| + | return -3 : if no rights to edit region | ||
| + | ''' The errors returned on parcel are: ''' | ||
| + | return 0 : Never 0 for now | ||
| + | return 1 : if daycycle applied with success | ||
| + | return -1 : if "Parcel Owners May Override Environment" isn't checked | ||
| + | (See menu "World/Region Details" on tab "Environment") | ||
| + | return -2 : if parcel not found (This is a bad thingy) | ||
| + | return -3 : if no rights to edit parcel | ||
|ossl_example=<source lang="lsl"> | |ossl_example=<source lang="lsl"> | ||
// | // | ||
| Line 16: | Line 29: | ||
integer transition = 3; | integer transition = 3; | ||
integer switch; | integer switch; | ||
| − | + | ||
default | default | ||
{ | { | ||
state_entry() | state_entry() | ||
{ | { | ||
| − | llSay(PUBLIC_CHANNEL, "Touch to see osResetEnvironment usage | + | llSay(PUBLIC_CHANNEL, "Touch to see osResetEnvironment usage."); |
| + | llSay(PUBLIC_CHANNEL, "Transition: " + (string)transition + " second(s)."); | ||
} | } | ||
| Line 28: | Line 42: | ||
integer result; | integer result; | ||
| − | if (switch =! switch) | + | if (switch = !switch) |
{ | { | ||
result = osResetEnvironment(switch, transition); | result = osResetEnvironment(switch, transition); | ||
| Line 38: | Line 52: | ||
} | } | ||
| − | if (switch == 1 && result | + | if (switch == 1 && result > 0) |
{ | { | ||
llSay(PUBLIC_CHANNEL, "The parcel environment was removed with success."); | llSay(PUBLIC_CHANNEL, "The parcel environment was removed with success."); | ||
| + | llSay(PUBLIC_CHANNEL, "The region environment is now used."); | ||
} | } | ||
| − | else if (switch == 1 && result | + | else if (switch == 1 && result < 0) |
{ | { | ||
llSay(PUBLIC_CHANNEL, "The parcel environment was removed without success."); | llSay(PUBLIC_CHANNEL, "The parcel environment was removed without success."); | ||
} | } | ||
| − | else if (switch == 0 && result | + | else if (switch == 0 && result > 0) |
{ | { | ||
llSay(PUBLIC_CHANNEL, "The region environment was set to the default with success."); | llSay(PUBLIC_CHANNEL, "The region environment was set to the default with success."); | ||
} | } | ||
| − | else if (switch == 0 && result | + | else if (switch == 0 && result < 0) |
{ | { | ||
llSay(PUBLIC_CHANNEL, "The region environment was set to the default without success."); | llSay(PUBLIC_CHANNEL, "The region environment was set to the default without success."); | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | '''With all errors message:''' | ||
| + | <source lang="lsl"> | ||
| + | // | ||
| + | // osResetEnvironment Script Example | ||
| + | // Author: djphil | ||
| + | // | ||
| + | |||
| + | integer transition = 3; | ||
| + | integer switch; | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Touch to see osResetEnvironment usage."); | ||
| + | llSay(PUBLIC_CHANNEL, "Transition: " + (string)transition + " second(s)."); | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | integer result; | ||
| + | |||
| + | if (switch = !switch) | ||
| + | { | ||
| + | result = osResetEnvironment(switch, transition); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | result = osResetEnvironment(switch, transition); | ||
| + | } | ||
| + | |||
| + | if (switch == 1 && result > 0) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The parcel environment was removed with success."); | ||
| + | llSay(PUBLIC_CHANNEL, "The region environment is now used."); | ||
| + | } | ||
| + | |||
| + | else if (switch == 1 && result < 0) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The parcel environment was removed without success."); | ||
| + | |||
| + | if (result == -1) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The \"Parcel Owners May Override Environment\" isn't checked ..."); | ||
| + | llSay(PUBLIC_CHANNEL, "(See menu \"World/Region Details\" on tab \"Environment\")"); | ||
| + | } | ||
| + | |||
| + | if (result == -2) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The parcel is not found (This is a bad thingy) ..."); | ||
| + | } | ||
| + | |||
| + | if (result == -3) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "You have no rights to edit parcel ..."); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | else if (switch == 0 && result > 0) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The region environment was set to the default with success."); | ||
| + | } | ||
| + | |||
| + | else if (switch == 0 && result < 0) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "The region environment was set to the default without success."); | ||
| + | |||
| + | if (result == -3) | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "You have no rights to edit region ..."); | ||
| + | } | ||
} | } | ||
} | } | ||
| Line 62: | Line 153: | ||
|additional_info=Added in 0.9.2 | |additional_info=Added in 0.9.2 | ||
}} | }} | ||
| + | == See Also == | ||
| + | * [[osReplaceAgentEnvironment]] | ||
| + | * [[osReplaceParcelEnvironment]] | ||
| + | * [[osReplaceRegionEnvironment]] | ||
| + | * [[osResetEnvironment]] | ||
Latest revision as of 12:25, 21 December 2020
 |
Languages: |
|
integer osResetEnvironment(integer ParcelOrRegion, integer transition)
| |
Resets parcel or region environment.
The errors returned on region are: return 0 : never 0 for now return 1 : if daycycle applied with success return -1 : never -1, it is on parcel only return -2 : never -2, it is on parcel only return -3 : if no rights to edit region The errors returned on parcel are: return 0 : Never 0 for now
return 1 : if daycycle applied with success
return -1 : if "Parcel Owners May Override Environment" isn't checked
(See menu "World/Region Details" on tab "Environment")
return -2 : if parcel not found (This is a bad thingy)
return -3 : if no rights to edit parcel
| |
| Threat Level | This function does not do a threat level check |
| Permissions | Prim owner must have estate manager rights or parcel and parcel environment change rights |
| Extra Delay | 0 seconds |
| Example(s) | |
// // osResetEnvironment Script Example // Author: djphil // integer transition = 3; integer switch; default { state_entry() { llSay(PUBLIC_CHANNEL, "Touch to see osResetEnvironment usage."); llSay(PUBLIC_CHANNEL, "Transition: " + (string)transition + " second(s)."); } touch_start(integer number) { integer result; if (switch = !switch) { result = osResetEnvironment(switch, transition); } else { result = osResetEnvironment(switch, transition); } if (switch == 1 && result > 0) { llSay(PUBLIC_CHANNEL, "The parcel environment was removed with success."); llSay(PUBLIC_CHANNEL, "The region environment is now used."); } else if (switch == 1 && result < 0) { llSay(PUBLIC_CHANNEL, "The parcel environment was removed without success."); } else if (switch == 0 && result > 0) { llSay(PUBLIC_CHANNEL, "The region environment was set to the default with success."); } else if (switch == 0 && result < 0) { llSay(PUBLIC_CHANNEL, "The region environment was set to the default without success."); } } } With all errors message: // // osResetEnvironment Script Example // Author: djphil // integer transition = 3; integer switch; default { state_entry() { llSay(PUBLIC_CHANNEL, "Touch to see osResetEnvironment usage."); llSay(PUBLIC_CHANNEL, "Transition: " + (string)transition + " second(s)."); } touch_start(integer number) { integer result; if (switch = !switch) { result = osResetEnvironment(switch, transition); } else { result = osResetEnvironment(switch, transition); } if (switch == 1 && result > 0) { llSay(PUBLIC_CHANNEL, "The parcel environment was removed with success."); llSay(PUBLIC_CHANNEL, "The region environment is now used."); } else if (switch == 1 && result < 0) { llSay(PUBLIC_CHANNEL, "The parcel environment was removed without success."); if (result == -1) { llSay(PUBLIC_CHANNEL, "The \"Parcel Owners May Override Environment\" isn't checked ..."); llSay(PUBLIC_CHANNEL, "(See menu \"World/Region Details\" on tab \"Environment\")"); } if (result == -2) { llSay(PUBLIC_CHANNEL, "The parcel is not found (This is a bad thingy) ..."); } if (result == -3) { llSay(PUBLIC_CHANNEL, "You have no rights to edit parcel ..."); } } else if (switch == 0 && result > 0) { llSay(PUBLIC_CHANNEL, "The region environment was set to the default with success."); } else if (switch == 0 && result < 0) { llSay(PUBLIC_CHANNEL, "The region environment was set to the default without success."); if (result == -3) { llSay(PUBLIC_CHANNEL, "You have no rights to edit region ..."); } } } } | |
| Notes | |
| Added in 0.9.2 | |
[edit] See Also
- osReplaceAgentEnvironment
- osReplaceParcelEnvironment
- osReplaceRegionEnvironment
- osResetEnvironment
