Difference between revisions of "LlCloud"

From Second Life Wiki
Jump to navigation Jump to search
Line 1: Line 1:
{{LSLFunctionAll|func_id=43|func_sleep=0.0|func_energy=10.0|func=llCloud|return_type=float|p1_type=vector|p1_name=offset|func_footnote
{{LSL_Function
|return_text=that is the cloud density at the object position + offset
|func_id=217|func_sleep=0.1|func_energy=10.0
|spec|caveats|examples|helpers|related=*{{LSLG|llWind}}|also|notes= How clouds work:
|sort=GetNotecardLine
 
|func=llGetNotecardLine
* SL features a cellular automata-based weather system.
|return_type=key
* There are 16x16 square cloud "cells" per sim (which means each is 16x16m in size).
|p1_type=string|p1_name=name|p1_desc=Notecard name or {{LSLG|UUID}}.
* The cloud density data is sent from the server to the client once every time the agent connects to a simulator via logging in or teleporting into a simulator.
|p2_type=integer|p2_name=line|p2_desc=Line number of a notecard.
* The client attempts to render clouds from the cloud algorithm results sent from the server, which is why different clients can see different cloud formations and de-synchronizes cloud view from the server over time.
|func_desc=Requests the line '''line''' of the notecard '''name''' from the dataserver.
* The Z value in the vector is irrelevant (clouds are always between about 180-200m absolute height).
|return_text=that is the handle for a {{LSLG|dataserver}} event responce.
* It returns a value between 0.0 and 1.0, with 0.0 being no clouds, and 1.0 very dense clouds.
|func_footnote=If '''line''' is passed the end of the notecard {{LSLG|EOF}} is returned by the {{LSLG|dataserver}}. If the return is a {{LSLG|NULL_KEY}} then notecard could not be found in inventory???
* Values returned above 1.0 - 2.0 indicate rainfall, but the option for rain is not currently implemented so values are capped at 1.0.
|spec
* Clouds and wind are related.
|caveats=* If the notecard cannot be found in inventory and it is not a UUID then an error will shouted on {{LSLG|DEBUG_CHANNEL}}.
 
|constants
 
|examples
The cloud seed/growth/dissipation algorithm uses a solenoidal vector field, which is a vector field with zero-divergence: nabla dot v = 0
|helpers
 
|also_functions=* {{LSLG|llGetNumberOfNotecardLines}}
This condition is satisfied whenever v has a vector potential, because if v = nabla times A then nabla dot v = nabla dot (nabla times A) = 0.}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
|also_events=* {{LSLG|dataserver}}
|also_articles
|notes
|permission
}}
{{LSLC|Stub|GetNotecardLine}}
{{LSLC|Notecard|GetNotecardLine}}
{{LSLC|Inventory|GetNotecardLine}}

Revision as of 21:24, 29 January 2007

Summary

Function: key llGetNotecardLine( string name, integer line );

Requests the line line of the notecard name from the dataserver.
Returns a key that is the handle for a dataserver event responce.

• string name – Notecard name or UUID.
• integer line – Line number of a notecard.

If line is passed the end of the notecard EOF is returned by the dataserver. If the return is a NULL_KEY then notecard could not be found in inventory???

Caveats

  • This function causes the script to sleep for 0.1 seconds.
  • If the notecard cannot be found in inventory and it is not a UUID then an error will shouted on DEBUG_CHANNEL.
All Issues ~ Search JIRA for related Bugs

Examples

See Also

Deep Notes

Search JIRA for related Issues

Signature

function key llGetNotecardLine( string name, integer line );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlCloud&oldid=7874"