LsGetWindlightScene
From OpenSimulator
(Difference between revisions)
(added note about passing an empty list into function) |
m |
||
(7 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
= lsGetWindlightScene = | = lsGetWindlightScene = | ||
== Function == | == Function == | ||
− | + | '''list''' lsGetWindlightScene('''list''' rules); | |
− | Get a list of the current [ | + | Get a list of the current [http://wiki.secondlife.com/wiki/WindLight_settings Windlight settings] in the scene |
− | * | + | * '''list''' rules - a list of the [[LightShare Parameters]] to retrieve |
An empty rules list will return an empty result list. | An empty rules list will return an empty result list. | ||
Line 12: | Line 12: | ||
== Examples == | == Examples == | ||
− | + | ||
− | + | <source lang="lsl"> | |
+ | list rules_to_get = [ WL_WATER_COLOR ]; | ||
+ | list settings; | ||
+ | |||
default { | default { | ||
state_entry() { | state_entry() { | ||
− | settings = | + | settings = lsGetWindlightScene(rules_to_get); |
llOwnerSay("Water color is: "+llList2String(settings,1)); | llOwnerSay("Water color is: "+llList2String(settings,1)); | ||
} | } | ||
} | } | ||
+ | </source> | ||
− | + | Water color is: <4.000000,38.000000,64.000000> | |
== Notes == | == Notes == | ||
Line 29: | Line 33: | ||
== See Also == | == See Also == | ||
=== Functions === | === Functions === | ||
− | *[[lsSetWindlightScene]] | + | * [[lsSetWindlightScene]] |
− | *[[lsSetWindlightSceneTargeted]] | + | * [[lsSetWindlightSceneTargeted]] |
+ | * [[lsClearWindlightScene]] | ||
=== Articles === | === Articles === | ||
− | *[[LightShare]] | + | * [[LightShare]] |
− | *[[LightShare Parameters]] | + | * [[LightShare Parameters]] |
== Deep Notes == | == Deep Notes == | ||
=== All Issues === | === All Issues === | ||
− | *http://opensimulator.org/mantis/search.php?project_id=1&search=lsGetWindlightScene&hide_status_id=-2 | + | * http://opensimulator.org/mantis/search.php?project_id=1&search=lsGetWindlightScene&hide_status_id=-2 |
+ | |||
+ | |||
+ | [[Category:Scripting]] |
Revision as of 15:53, 24 October 2015
Contents |
lsGetWindlightScene
Function
list lsGetWindlightScene(list rules);
Get a list of the current Windlight settings in the scene
- list rules - a list of the LightShare Parameters to retrieve
An empty rules list will return an empty result list.
Caveats
The list returned by this function cannot be passed directly to lsSetWindlightScene without triggering C# exceptions from the Simulator.
Examples
list rules_to_get = [ WL_WATER_COLOR ]; list settings; default { state_entry() { settings = lsGetWindlightScene(rules_to_get); llOwnerSay("Water color is: "+llList2String(settings,1)); } }
Water color is: <4.000000,38.000000,64.000000>
Notes
Returned rules contain pairs of data in the form of the parameter requested followed by the current value. In the example above, the request returns [ 0, <4.000000,38.000000,64.000000> ] when used with default LightShare settings in a region.