View source for OpenSim.Region.ScriptEngine.DotNetEngine

== DotNetEngine ==

Namespace: OpenSim.Region.ScriptEngine.DotNetEngine

DotNetEngine is a ScriptEngine that executes LSL scripts contained within objects.<br />
Core development blog: [http://teddmaa.blogspot.com] <br />

----
===How it works===
1. Create instance of ScriptEngine(scene).<br />
2. ScriptEngine will create instances of:<br />
 EventManager
 EventQueueManager
 ScriptManager
3. EventManager will hook up all necessary events (all possible script events, script rez, script derez, etc).<br />
4. When events are received, they are processed inside EventManager.<br />
 For example:
 Event for loading a script will be processed and EventManager will tell ScriptManager to load the script.
 Event such as touch_start is received in EventManager and translated to LSL-compatible request before being sent to EventQueueManager.
Note! If event is for a particular object, EventQueueManager will queue event for all scripts inside that object.<br />
5. If script is LSL then OpenSim.Region.ScriptEngine.DotNetEngine.Compiler.LSL is used to compile the script to .Net Assembly.<br />
6. EventQueueManager has a separate thread running to process its event queue. Events are actually functions inside the script .dll that is called "<state>_event_<event_name>" for example "default_event_touch_start". State is read from a global variable in the script .dll.<br />

----
===Places to extend script support===
* LSL_BaseClass.cs
These are the functions script can use to manipulate the scene. Commonly known as ll-functions. They are LSL functions such as llSay, llWhisper, etc.
* EventManager.cs
This is where events are coming from server and being queued for scripts. All 16 or so LSL events needs to be implemented here.

This image is a bit old, but gives you an idea...
[[Image:ScriptEngineLayout2.png]]