LsSetWindlightScene

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(created)
 
(fixed mantis link)
Line 47: Line 47:
 
== Deep Notes ==
 
== Deep Notes ==
 
=== All Issues ===
 
=== All Issues ===
*http://opensimulator.org/mantis/search.php?project_id=1&search=lsSetWindlightScene
+
*http://opensimulator.org/mantis/search.php?project_id=1&search=lsSetWindlightScene&hide_status_id=-2

Revision as of 23:50, 5 November 2010

Contents

lsSetWindlightScene

Function

integer lsSetWindlightScene(list rules);

Set a list of Windlight settings in the scene to new values

  • list rules - a list containing pairs of parameters and values to set

Caveats

The list used by this function cannot be passed directly from lsGetWindlightScene without triggering C# exceptions from the Simulator.

LightShare must be enabled in the Simulator.

This script function is restricted to the region owner only.

Examples

 list settings = [ WL_WATER_COLOR, <4.000000,38.000000,64.000000> ];
 integer success;
 default {
   state_entry() {
     success = lsSetWindlightScene(settings);
     if ( success == TRUE ) {
       llOwnerSay("Success!");
     } else {
       llOwnerSay("Failed!");
     }
   }
 }

Notes

Rules contain pairs of data in the form of the parameter followed by the value to set.

Setting new parameters with this function commits the new changes to the regionwindlight database table immediately.

Excessive use of this function can cause unnecessary database requests.

Use lsSetWindlightSceneTargeted if you wish to avoid database loading with this function.

See Also

Functions

Articles

Deep Notes

All Issues

Personal tools
General
About This Wiki