VorlageDokuCmdConfig

#config

Einlesen von Konfigurationsdaten als Objekt

Syntax

#config <Kapitel> [FILE <Datei>] <Mode> [<Spalten> ...]

Beschreibung

Der Befehl kann Tabellen aus dem Config-File in globale Objekte laden. Wichtig ist, das der Dateiname ein String ist, also in Hochkommas eingefasst werden sollte. Dabei gibt es drei Modes die Tabellenformaten im Config-File entsprechen.

Parameter

Kapitel

Selektiert das Konfigurations-Datei-Kapitel das die Tabelle enthält

Datei

Gibt an, das statt der normalen Konfigurationsdatei die hier angegebene verwendet werden soll

Mode

Dieser Parameter gibt an wie die Tabelle in ein Objekt überführt werden soll.

Spalten

Hier werden die für den Modus TABH vorgesehenen Spaltennamen als Attributsnamen angegeben.

Es werden folgende Modi unterstützt:

TABH

Horizontale Objekt-Anordnung, d.h. alle Attribute in einer Zeile (z.b. Castles oder Things im Config-File).

Hier müssen die Attributnamen, ohne die erste Spalte, angegeben werden, die erste Spalte ist Index und kann auch als Attribut NAME erfragt werden

Beispiel:

#config Castles tabh groesse bonus

erzeugt mit eressea.cfg ein Object bei dem der Aufruf

CASTLES['Festung'].GROESSE

250 ergibt

TABV

Vertikale Objekt-Anordnung, d.h. alle Attribute in einer Spalte (z.b. Races im Config-File). Hier sind die Attributnamen in der ersten Spalte, die erste Zeile ist Index und kann als Attribut NAME erfragt werden.

Beispiel:

#config Races tabv

erzeugt ein Object RACES welches sich genau so verhält wie das eingebaute, welches wohl mittelfristig entfernt wird.

NESTED

Verschachteltes Object, mit einer Ebene Unterobjekten, d.h. das Objekt ist Komplett in einer Zeile angegeben, aber mit einem speziellen Aufbau: Erster Eintrag ist der Index, der auch unter NAME erreichbar ist, dann folgt eine Kette von Subobjekten die immer durch den Subobjekt-Namen gefolgt von den Attributen als Zahl/Namens-Paare aufgelistet werden. Dieser Aufbau impliziert, das nur Numerische Attribute möglich sind

Beispiel:

#config Buildings nested

erzeugt ein Object BUILDINGS bei welchem der Aufruf

BUILDINGS['Saegewerk'].BAUKOSTEN.STEIN

den Wert 5 ergibt

Beispiel

Um aus einer Datei ../configs/meineconfig.cfg die Tabelle [MeinKapitel] in Objekte mit den Attributen x, y und z zu laden, benutzt man:

#config MeinKapitel FILE '../configs/meineconfig.cfg' TABH x y z

Referenzen

Installation