- GetDefCoreVal(string entry, string section, id definition);
- GetObjectVal(string entry, string section, object obj);
- GetObjectInfoCoreVal(string entry, string section, object obj);
- GetScenarioVal(string entry, string section);
- GetPlayerVal(string entry, string section, int player);
- GetPlayerInfoCoreVal(string entry, string section, int player);
GetDefCoreVal, GetObjectVal, GetScenarioVal
Diese Funktionsfamilie gewährt direkten Zugriff auf sämtliche Eigenschaften der entsprechenden Objekte, wie sie auch abgespeichert werden.
Dabei entsprechen die Funktionen jeweils folgenden Dateien:
| Funktion | Datei |
|---|---|
| GetDefCoreVal | DefCore.txt |
| GetObjectVal | Objects.txt |
| GetObjectInfoCoreVal | *.oci (in Spielerdateien) |
| GetScenarioVal | Scenario.txt |
| GetPlayerVal | scenario.txt |
| GetPlayerInfoCoreVal | player.txt |
Die Eigenschaft wird jeweils anhand ihres Namen und ggf. der Sektion übergeben (wird nichts übergeben, so werden alle Sektionen nach einem gleichnamigen Wert durchsucht). Wurde eine entsprechende Eigenschaft nicht gefunden oder entsprcht der Typ der Eigenschaft keinem gültigen Script-Datenformat (z.B. ID-Liste), so wird
nil zurückgegeben.Wird in GetObjectVal für obj/definition jeweils
nil angegeben, so wird das Objekt (bzw. dessen Definition), aus dem der Aufruf erfolgte angenommen.Die Zusatzfunktionen GetXVal.c (in System.ocg) ermöglichen Aufrufe verschiedener Get*Val-Funktionen durch globale Scriptfunktionen (z.B.
GetObjWidth(), entspricht GetObjectVal("Width", 0)).