Luascenery: Różnice pomiędzy wersjami
Z MaSzyna
(Utworzono nową stronę "Obecnie w eksperymentalnych buildach @milek7 do częściowego sterowania eventami na sceneriach można użyć języka skryptowego Lua 5.1 (implementacja LuaJIT) Uwaga:...") |
|||
Linia 5: | Linia 5: | ||
Skrypt dołącza się do scenerii poprzez dyrektywę <code>lua <ścieżka do skryptu></code>. | Skrypt dołącza się do scenerii poprzez dyrektywę <code>lua <ścieżka do skryptu></code>. | ||
Funkcje do interakcji z symulatorem dołączane są przez moduł <code>eu07.events</code>: | Funkcje do interakcji z symulatorem dołączane są przez moduł <code>eu07.events</code>: | ||
− | < | + | <nowiki> |
TEvent* event_create(const char* name, void (*handler)(TEvent*, TDynamicObject*), double delay); | TEvent* event_create(const char* name, void (*handler)(TEvent*, TDynamicObject*), double delay); | ||
TEvent* event_find(const char* name); | TEvent* event_find(const char* name); | ||
Linia 27: | Linia 27: | ||
double random(double a, double b); | double random(double a, double b); | ||
void writelog(const char* txt); | void writelog(const char* txt); | ||
− | </ | + | </nowiki> |
Funkcje manipulujące obiektami przyjmują wskaźnik do wewnętrznych struktur C++ który zwykle może być wyszukany po nazwie przez odpowiednią funkcję *_find. | Funkcje manipulujące obiektami przyjmują wskaźnik do wewnętrznych struktur C++ który zwykle może być wyszukany po nazwie przez odpowiednią funkcję *_find. | ||
Linia 35: | Linia 35: | ||
scenery/td.scn: | scenery/td.scn: | ||
− | < | + | <nowiki> |
node -1 0 komorka1 memcell 1.0 1.0 1.0 abc 1 2 none endmemcell | node -1 0 komorka1 memcell 1.0 1.0 1.0 abc 1 2 none endmemcell | ||
event logval logvalues 0 komorka1 endevent | event logval logvalues 0 komorka1 endevent | ||
Linia 68: | Linia 68: | ||
end, 0) -- tu jeszcze ostatni argument event_create, opóźnienie eventu | end, 0) -- tu jeszcze ostatni argument event_create, opóźnienie eventu | ||
− | </ | + | </nowiki> |
Wersja z 16:17, 31 sie 2017
Obecnie w eksperymentalnych buildach @milek7 do częściowego sterowania eventami na sceneriach można użyć języka skryptowego Lua 5.1 (implementacja LuaJIT)
Uwaga: API eksperymentalne, może sie jeszcze znacząco zmienić
Skrypt dołącza się do scenerii poprzez dyrektywę lua <ścieżka do skryptu>
.
Funkcje do interakcji z symulatorem dołączane są przez moduł eu07.events
:
TEvent* event_create(const char* name, void (*handler)(TEvent*, TDynamicObject*), double delay); TEvent* event_find(const char* name); const char* event_getname(TEvent *e); void event_dispatch(TEvent *e, TDynamicObject *activator); void event_dispatch_n(const char* name, TDynamicObject *activator); TTrack* track_find(const char* name); bool track_isoccupied(TTrack *track); bool track_isoccupied_n(const char *name); const char* train_getname(TDynamicObject *dyn); void dynobj_putvalues(TDynamicObject *dyn, memcell_values v); TMemCell* memcell_find(const char *name); memcell_values memcell_read(TMemCell *mc); memcell_values memcell_read_n(const char *name); void memcell_update(TMemCell *mc, memcell_values v); void memcell_update_n(const char *name, memcell_values v); double random(double a, double b); void writelog(const char* txt);
Funkcje manipulujące obiektami przyjmują wskaźnik do wewnętrznych struktur C++ który zwykle może być wyszukany po nazwie przez odpowiednią funkcję *_find. Istnieją też funkcje pomocnicze *_n, które odwołują się do obiektów przez nazwę. (wewnętrznie też wywołują _find)
Podstawowy przykład
scenery/td.scn:
node -1 0 komorka1 memcell 1.0 1.0 1.0 abc 1 2 none endmemcell event logval logvalues 0 komorka1 endevent lua td.lua </code> scenery/td.lua: <code> local api = require "eu07.events" --użycie modułu API api.writelog(tostring(api.random(5, 20))) --wypisywanie losowej liczby do loga --definiujemy event typu tp_Lua. funkcja callback przyjmuje argumenty: TEvent* który wywołał funkcję, TDynamicObject* który aktywował event (może być nil) api.event_create("onstart_lua", function(event, activator) --odczytuje memcell "komorka1" local mc = api.memcell_read_n("komorka1") --coś tam grzebiemy w wartościach mc.str = "def" mc.num1 = 3 mc.num2 = 4 --zapisujemy zmienioną komórkę api.memcell_update_n("komorka1", mc) --uruchamiamy event "logval" żeby zobaczyć że memcell się zaktualizował (tak można wywołać dowolny event na scenerii, też te zdefiniowane w lua) api.event_dispatch_n("logval", activator) --zaświecamy coś tam na semaforze api.event_dispatch_n("stacja1_a_s13", activator); end, 0) -- tu jeszcze ostatni argument event_create, opóźnienie eventu