aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/LuaSL
diff options
context:
space:
mode:
authorDavid Walter Seikel2012-01-04 19:31:42 +1000
committerDavid Walter Seikel2012-01-04 19:31:42 +1000
commit1248b3f118e0d55cdeb1ab1221a83109caaf51b9 (patch)
treeb1cef2fcbc5634aa121364ac8a3feaed1515539e /LuaSL
parentAdd the base Enlightenment Foundation Libraries - eina, eet, evas, ecore, emb... (diff)
downloadSledjHamr-1248b3f118e0d55cdeb1ab1221a83109caaf51b9.zip
SledjHamr-1248b3f118e0d55cdeb1ab1221a83109caaf51b9.tar.gz
SledjHamr-1248b3f118e0d55cdeb1ab1221a83109caaf51b9.tar.bz2
SledjHamr-1248b3f118e0d55cdeb1ab1221a83109caaf51b9.tar.xz
Make some plans.
Diffstat (limited to 'LuaSL')
-rw-r--r--LuaSL/README65
1 files changed, 64 insertions, 1 deletions
diff --git a/LuaSL/README b/LuaSL/README
index 2236bae..7dbf922 100644
--- a/LuaSL/README
+++ b/LuaSL/README
@@ -1 +1,64 @@
1Refer to - http://wiki.infinitegrid.org/index.php/LuaSL_-_New_scripting_engine \ No newline at end of file 1Refer to - http://wiki.infinitegrid.org/index.php/LuaSL_-_New_scripting_engine
2
3LuaSL is a Lua based LSL scripting engine that will aim for LSL
4compatability first, then adding Lua extensions. It aims to replace the
5woeful XEngine from OpenSim, and at a later stage, be the basis for a
6client side scripting engine.
7
8
9Design.
10-------
11
12The basic design will be made up as I go along, but so far I have this -
13
14An object is a file system directory, full of LSL scripts as text files,
15notecards as text files, animations as BVH (or later BVJ) files, etc.
16There will be some sort of metadata in place.
17
18A parser parses an LSL script, validating it and reporting errors.
19
20A preprocessor takes the result of the parse, and converts it into Lua
21source. Each LSL script becomes a Lua state. LSL states are handled as
22Lua tables, with each LSL state function being a table function in a
23common metatable. LL and OS functions are likely to be C functions.
24Careful testing should be done with LuaJIT FFI, sandboxing, and
25performance testing.
26
27The Lua source is compiled by the Lua compiler.
28
29LuaJIT is used as the Lua compiler, library, and runtime.
30
31Luaproc is used to start up operating system threads and hand Lua
32states between them.
33
34Nails is used to pump commands in and out of the LuaSL system. Incoming
35commands invoke LSL events via the LuaSL state metatable. LL and OS
36functions that impact the world will be converted to nails commands sent
37to the command pump.
38
39A watchdog thread is used to make sure no LuaSL script spends forever
40processing any event.
41
42Some form of serialization will need to be created for saving script
43state during shutdowns, passing script state to other threads /
44processes / computers.
45
46
47Test harness.
48-------------
49
50I'll build a test harness. It will be based on EFL Edje Lua, with
51buttons for triggering LSL events, SL style dialogs, and other goodies.
52
53The initial goal will be to run standard MLP scripts. They have minimal
54interface to the world, and exercise quite a bit of the rest of LSL.
55They are also quite common, and sometimes responsible for a lot of the
56script running load.
57
58Various eina logging domains will be used to handle whisper, say, shout,
59etc.
60
61Performance testing will have to be done on 5000 scripts, to see how
62that compares against XEngine.
63
64