aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/LuaSL/README
blob: c019fb737e6ca57f2018ef6ba0435d4f03be1902 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
Refer to - http://wiki.infinitegrid.org/index.php/LuaSL_-_New_scripting_engine

LuaSL is a Lua based LSL scripting engine that will aim for LSL
compatability first, then adding Lua extensions.  It aims to replace the
woeful XEngine from OpenSim, and at a later stage, be the basis for a
client side scripting engine.

To compile this, you will need Enlightenment Foundation Libraries (EFL)
installed in either /opt/e17 or /usr.  These are typical places it get's
installed in.


Design.
-------

The basic design will be made up as I go along, but so far I have this -

An object is a file system directory, full of LSL scripts as text files,
notecards as text files, animations as BVH (or later BVJ) files, etc. 
There will be some sort of metadata in place.

A parser parses an LSL script, validating it and reporting errors.

A preprocessor takes the result of the parse, and converts it into Lua
source.  Each LSL script becomes a Lua state.  LSL states are handled as
Lua tables, with each LSL state function being a table function in a
common metatable.  LL and OS functions are likely to be C functions. 
Careful testing should be done with LuaJIT FFI, sandboxing, and
performance testing.

The Lua source is compiled by the Lua compiler.

LuaJIT is used as the Lua compiler, library, and runtime.

Luaproc is used to start up operating system threads and hand Lua
states between them.

Nails is used to pump commands in and out of the LuaSL system.  Incoming
commands invoke LSL events via the LuaSL state metatable.  LL and OS
functions that impact the world will be converted to nails commands sent
to the command pump.

A watchdog thread is used to make sure no LuaSL script spends forever
processing any event.

Some form of serialization will need to be created for saving script
state during shutdowns, passing script state to other threads /
processes / computers.


Test harness.
-------------

I'll build a test harness.  It will be based on EFL Edje Lua, with
buttons for triggering LSL events, SL style dialogs, and other goodies.

The initial goal will be to run standard MLP scripts.  They have minimal
interface to the world, and exercise quite a bit of the rest of LSL. 
They are also quite common, and sometimes responsible for a lot of the
script running load.  Gotta start somewhere, so start with the ~run
script.

Various eina logging domains will be used to handle whisper, say, shout,
etc.

Performance testing will have to be done on 5000 scripts, to see how
that compares against XEngine.