66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
|
# KsKit für Eisenbahn.exe
|
||
|
|
|
||
|
|
KsKit ist eine Sammlung von Lua-Funktionalität, welche ich auf meinen Anlagen für eine vorbildgerechte Signalisierung einsetze.
|
||
|
|
Die hier geschilderten Anwendungsfälle und Programmsnipsel stellen kein Komplettpacket dar, sondern sind eher wie ein Kuchen anzusehen, aus denen man sich ein paar Rosinen rauspicken darf.
|
||
|
|
|
||
|
|
Aus dem Basisscript dürfen Teile entnommen werden und anderswo verwendet werden, dabei ist die Herkunft und Versionsnummer zu nennen, z.B. als Quellcode-Kommentar.
|
||
|
|
Die Versionsnummer befindet sich am Anfang des Basisscripts und kann über die Variable `KsKitVer` abgefragt werden.
|
||
|
|
|
||
|
|
## Einrichtung
|
||
|
|
|
||
|
|
Das KsKit-Verzeichnis wird im EEP-Stammverzeichnis, dort im LUA/ Unterverzeichnis als ganzes hin entpackt.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Die Einbindung vom Anlagenscript aus erfolgt mittels `require("kskit")`.
|
||
|
|
|
||
|
|
**Wichtig**: Wenn KsKit verwendet wird, darf keine EEPMain definiert sein.
|
||
|
|
|
||
|
|
Findet EEP die Dateien von Lua nicht, wird im Ereignisfenster eine Liste von Orten ausgegeben, an denen die Dateien gesucht wurden.
|
||
|
|
Die Orte sind in diesem Fall mit dem Installationsort abzugleichen.
|
||
|
|
|
||
|
|
## Allgemeine Lua-Kniffe
|
||
|
|
|
||
|
|
Bei der Entwicklung des Basisscriptes haben sich einige Mechanismen als sehr praktisch erwiesen, um die Komplexität des Codes im Zaum zu halten.
|
||
|
|
|
||
|
|
### Mainfunktionen
|
||
|
|
|
||
|
|
Das Basisscript bringt eine eigene EEPMain mit, daher darf von Seiten des Anlagen-Scriptes keine weitere EEPMain definiert werden.
|
||
|
|
Soll Lua-Code im Rahmen der EEPMain ausgeführt werden, wird mittels MainFunktion() eine Lambda-Funktion registriert.
|
||
|
|
Als Argument wird eine Funktion übergeben, welche keine Argumente nimmt.
|
||
|
|
Diese Funktion wird dann in jedem Zyklus einmal aufgerufen.
|
||
|
|
|
||
|
|
Der Vorteil dieser Verfahrensweise liegt darin, das vom User keine EEPMain mit Referenzen auf verschiedene Anlagenkomponenten angelegt und aktualisiert werden muss.
|
||
|
|
Auf einer Anlage können beliebig viele Mainfunktionen eingesetzt werden.
|
||
|
|
|
||
|
|
```
|
||
|
|
MainFunktion(function()
|
||
|
|
if EEPGetSignalTrainsCount(1) > 0 then
|
||
|
|
EEPSetSignal(1, 1, 1)
|
||
|
|
end
|
||
|
|
end)
|
||
|
|
```
|
||
|
|
|
||
|
|
Dieser Programmcode bindet eine Funktion an die EEPMain.
|
||
|
|
Die Funktion fragt ab, ob vor einem Signal ein Zug steht und schaltet in diesem Falle das Signal auf Fahrt.
|
||
|
|
|
||
|
|
### Signalfunktionen
|
||
|
|
|
||
|
|
Analog zu den Mainfunktionen ergibt sich ein ähnliches Problem mit den Signal-Callbacks.
|
||
|
|
Ein herkömmlicher Signal-Callback kann nur an einer einzigen Stelle definiert werden.
|
||
|
|
An einigen Stellen ist es jedoch notwendig, das mehrere Stellen über ein Umschalten eines Signals informiert werden wollen.
|
||
|
|
|
||
|
|
Mittels der SignalFunktion kann eine Funktion an ein Signal angebunden werden.
|
||
|
|
Ändert das Signal nun seine Stellung, wird die Funktion mit der neuen Stellung als Argument aufgerufen.
|
||
|
|
|
||
|
|
Als konkretes Beispiel sind einzelnstehende Vorsignale im Bahnhofsbereich zu betrachten.
|
||
|
|
Mehere Vorsignale können von einem Hauptsignal abhängig sein und benötigen Informationen über dessen Schaltzustand als auch über den Schaltzustand der dazwischenliegenden Fahrstrasse.
|
||
|
|
|
||
|
|
Als Beispiel wird eine Signalfunktion definiert, welche lediglich die neue Stellung eines Signals ausgibt:
|
||
|
|
|
||
|
|
```
|
||
|
|
SignalFunktion(1, function(Stellung)
|
||
|
|
print("Signal auf ", Stellung, " umgestellt")
|
||
|
|
end)
|
||
|
|
```
|