Das Programm benötigt zum Betrieb Gleisplan-Informationen, die es aus einer externen Textdatei (*.txt) einlesen kann. Das Programm verwaltet weiterhin noch die Datei paramet.txt, in der die Com-Schnittstelle (als Index 0 oder 1), der Dateiname der Gleisplan-Datei und die Fahrwerte der 28 Fahrstufen eingetragen sind. Es wird vorausgesetzt, dass sich die Textdateien im selben Ordner befinden wie die Programmdatei, daher wurde bewusst auf die Auswahl von Laufwerken und Ordnern verzichtet. Beim Start des Programms ist daher auch darauf zu achten, dass current-path (also der aktuell ausgewählte Ordner) der Ordner mit dem Programm und den zugehörigen Textdateien ist.
Das Format der Gleisplan-Datei
Die Gleisplan-Datei enthält Schlüsselworte, Parameter und Kommentare. Die Kommentare werden durch Apostroph (') eingeleitet. Steht vor dem Apostroph ein Parameter, so ist zwischen dem letzten Parameter und dem Apostroph ein Leerzeichen einzufügen, ansonsten wird der Parameter falsch eingelesen. Schlüsselworte und Parameter werden durch Leerzeichen getrennt. Schlüsselworte müssen am Zeilenanfang beginnen. Zeilen ohne gültiges Schlüsselwort werden beim Einlesen ignoriert.
Liste der Schlüsselworte und zugehörigen Parameter:
titel Titel, der in die Titelzeile des Programmfensters eingeblendet wird. Der Rest der Zeile nach dem Schlüsselwort-Leerzeichen wird in die Kopfzeile des Programmfensters übernommen.
bytes Anzahl der auszugebenden Bytes, also Anzahl der angeschlossenen Baugruppen.
Anzahl Anzahl der Bytes, max. 32
maßstab Angabe des Rasters, in dem das Gleisbild dargestellt wird.
360 Die Zahl gibt die Anzahl der Twips pro Rastereinheit an. Werte zwischen 240 und 600 könnten sinnvoll sein.
hoch Höhe des Fensters.
Höhe Die Angabe erfolgt in Rastereinheiten, wobei der Gleisabstand 2 Rastereinheiten betragen soll.
breit Breite des Fensters.
Breite Die Angabe erfolgt in Rastereinheiten, wobei der Gleisabstand 2 Rastereinheiten betragen soll.
skaus Anzeigeposition des Schaltknopfes "alles aus". Die Angabe aller Positionen erfolgt in Rastereinheiten.
x1 waagerechte Position
y1 senkrechte Position
skwei Anzeigeposition des Schaltknopfes "Weichen nochmal stellen". Die Angabe aller Positionen erfolgt in Rastereinheiten.
x1 waagerechte Position
y1 senkrechte Position
freg BitNummer und Anzeigeposition eines Fahrtreglers. Es stehen maximal 2 Fahrtregler zur Verfügung.
Bitnummer Bitposition des ersten Bits des Fahrtregler-Bytes im Bitstrom (1 bis 248 im Raster 8)
x1 waagerechte Anzeigeposition
y1 senkrechte Anzeigeposition
gleis Anzeigeposition eines Dummy-Gleises. Ein Dummy-Gleis hat keine Eingabefunktion und kann daher auch nicht bedient werden. Allerdings kann es zur Darstellung der Verlängerung eines Abschaltgleises genutzt werden, indem man eine Stromkreisnummer angibt.
x1 waagerechte Anzeigeposition Linienbeginn
y1 senkrechte Anzeigeposition Linienbeginn
x2 waagerechte Anzeigeposition Linienende
y2 senkrechte Anzeigeposition Linienende
Stromkreisnummer Nummer eines Abschaltgleises, beginnend mit 1. Ist diese angegeben, so wird das Dummy-Gleis in der Farbe des Abschaltgleises dargestellt. Bei 0 ist diese Funktion deaktiviert.
agleis Bitnummern und Anzeigeposition eines Abschalt-Gleises. Ein Abschalt-Gleis kann mit einem Schaltknopf bedient werden, der automatisch in der Mitte der Gleislinie platziert wird. Es erscheint in hellgrau wenn es abgeschaltet ist und nimmt die Farbe eines Fahrtreglers an, wenn es diesem Fahrtregler zugeschaltet ist. Durch Verlinkung von Dummy-Gleisen auf ein Abschalt-Gleis kann die Darstellung (Bildschirm) auch um die Ecke verlängert werden.
Bitnummer 1 Bitposition (1 bis 256) im Bitstrom für das Relais, das das Gleis mit Fahrtregler 1 verbindet. Bei Eingabe einer 0 ist keine Verbindung mit Fahrtregler 1 vorgesehen.
Bitnummer 2 Bitposition (1 bis 256) im Bitstrom für das Relais, das das Gleis mit Fahrtregler 2 verbindet. Bei Eingabe einer 0 ist keine Verbindung mit Fahrtregler 2 vorgesehen.
x1 waagerechte Anzeigeposition Linienbeginn
y1 senkrechte Anzeigeposition Linienbeginn
x2 waagerechte Anzeigeposition Linienende
y2 senkrechte Anzeigeposition Linienende
Aufruftaste Ein mit der Tastatur erreichbares Zeichen, das auf dem Schaltknopf angezeigt wird und durch dessen Eingabe der Schaltvorgang ausgelöst werden kann.
weiche Bitnummern und Anzeigeposition einer Weiche. Eine Weiche kann mit einem Schaltknopf bedient werden, der automatisch in der Wurzel der Weiche platziert wird. Die Weiche wird durch zwei Linien dargestellt, die von einem gemeinsamen Ursprung (Wurzel) in verschiedene Richtungen zeigen. Die aktive Weichenlage wird mittels dicker Linie in schwart dargestellt, die inaktive Weichenlage mit einer dünnen Linie in hellgrau.
Bitnummer 1 Bitposition (1 bis 256) im Bitstrom für die Weichenspule, die die Weiche in Ruhelage (gerade) schaltet.
Bitnummer 2 Bitposition (1 bis 256) im Bitstrom für die Weichenspule, die die Weiche in Arbeitslage (Abzweig) schaltet.
Aufruftaste Ein mit der Tastatur erreichbares Zeichen, das auf dem Schaltknopf angezeigt wird und durch dessen Eingabe der Schaltvorgang ausgelöst werden kann.
Die Bitnummern beginnen an der Schieberegisterkarte, die sich (elektrisch) am dichtesten am PC befindet. Die erste Karte hat die Nummern 1 bis 8, die nächste 9 bis 16, und so weiter. Es sind maximal 32 Karten, also 256 Bits möglich. Ein Fahrtregler-Kanal benötigt 8 zusammenliegende Bits, von denen in der Gleisplan-Datei nur die untere Bitnummer angegeben wird.