Mit dem nächsten Patch wird ein neues Lua-Handbuch zu EEP 17 erscheinen. Doch wie heißt es immer so schön bei ARD und ZDF: "Und jetzt schon in der Mediathek Filebase".
Das komplette Handbuch besteht aus 3 Dateien:
· Lua_manual.pdf (EEP-spezifische Lua-Variablen und -Funktionen)
· Lua-Grundlagen.pdf (Grundlagen zu Lua in EEP)
· Lua-Tutorialanlagen.pdf (EEP-Tutorialanlagen mit Lua)
in einer ZIP-Datei zusammengefasst.
Diese 3 Dateien können - so wie sie sind - in den Ordner "Handbuch" unter EEP 17 entpackt bzw. kopiert werden.
ACHTUNG: die 3 PDF-Dateinamen dürfen nicht umbenannt werden.
Über den Menupunkt "Hilfe -> Lua-Handbuch" in EEP wird immer die Datei Lua_manual.pdf aufgerufen, d.h. die Beschreibung der spezifischen Variablen und Funktionen.
Auf dem Deckblatt jeder Datei befinden sich Links auf die jeweils anderen 2 Dateien. So kann man das "komplette" Handbuch in einem PDF-Viewer (z.B. dem Adobe Acrobat Reader oder anderen) öffnen und jeder Zeit über die Reiter quer in die einzelnen Bereiche wechseln und in jedem Bereich auf und ab scrollen.
Auf den Reitern im PDF-Viewer erscheint jeweils der oben fett geschriebene "Titel".
In den Fußzeilen der 3 Dateien befindet jeweils ein Link auf das entsprechende Inhaltsverzeichnis auf dem Deckblatt, über das man wiederum schnell auf die einzelnen Kapitel gelangt.
Was gibt es in EEP 17 Neues zu Lua?
Über die Einbindung eines externen Editors wurde ja schon hier im MEF berichtet. Es steht aber natürlich auch im Handbuch
In 2D und 3D werden Kontaktpunkte, in denen Lua-Funktionen aufgerufen werden, gekennzeichnet (siehe hier).
Natürlich sind alle Funktionen aus den Plug-ins 1 und 4 zu EEP 16 in EEP 17 enthalten. Die dabei eingeführten Funktionen EEPSetCameraPosition(), EEPSetCameraRotation() und EEPGetFogIntensity() wurden gefixt. EEPRollingstockSetUserCamera() arbeitete bereits seit Plugin 1 korrekt, nur war der Parameter einer Rotationsachse falsch bezeichnet. Dies wurde in der Beschreibung korrigiert und deutlicher dargestellt.
Die Funktion EEPOnSaveAnl() wird weiterhin nach dem Speichern ausgeführt und gibt daher "nur" den Speicherpfad zurück.
Aber um festlegen zu können, was vor dem Speichern passieren soll (z.B. Daten in Slots oder Tag-Texten speichern) gibt es ab EEP 17 die neue Funktion EEPOnBeforeSaveAnl(). (Wer sich über das "On" im Namen wundert, dem sei gesagt, dass es sich um eine sog. Callback(Rückruf)-Funktion handelt und da in EEP alle Callback-Funktionen mit "EEPOn" beginnen, auch diese.)
Weiterhin neu ist die spezifische Variable EEPLng. Sie liefert das Kürzel (GER, ENG, FRA) für die Sprachversion der aktuell geöffneten EEP-Version.
Neu ist auch die Funktion EEPRollingstockGetUserCamera(), die Gegenfunktion zu EEPRollingstockSetUserCamera().
EEPGetAnlVer() liefert ab EEP 17 die EEP-Versionsnummer, mit der die Anlage vor dem Öffnen zuletzt gespeichert wurde.
Und EEPGetAnlLng() liefert die auf Achsnamen bezogene "Anlagensprache" (als GER, ENG oder FRA). Diese wird mit dem ersten Einsetzen eines Modells mit Achsen von EEP vergeben und ändert sich danach nicht mehr. Solange noch kein Modell mit Achsen eingesetzt wurde, entspricht diese "Anlagensprache" der Sprache der aktuellen EEP-Version, d.h. der EEP-spezifischen Variablen EEPLng.
Ich wünsche allen viel Spaß mit dem neuen Lua-Handbuch und natürlich mit Lua in EEP.
Und hier geht's zum Download: