Oblivion:Variablen

Aus Skript-Wiki
Wechseln zu: Navigation, Suche

Allgemeines zu Variablen im CS

Die Scriptsprache des TESIVCS enthält Variablen wie andere Programmiersprachen auch. Es gibt drei unterschiedliche Datentypen und zwei Gültigkeitsbereiche.


Variablentypen

Der Typ Short

Der Typ Short speichert ganzzahlige (integer) Werte. Im TESCS ist ein Mitinteger-Format, das 16 Bit also 2 Byte belegt). Da ein Bit für die Darstellung des Vorzeichen benötigt wird, können die Variablen von -215 (-32768) bis 215-1 (+32767) reichen.


Der Typ Long

Der Typ Long speichert ganzzahlige (integer) Werte. Im TESCS ist ein integer-Format, das 326 Bit also 4 Byte belegt). Da ein Bit für die Darstellung des Vorzeichen benötigt wird, können die Variablen von -231 (-2147483647) bis 231-1 (+2147483647) reichen.


Der Typ Float

Der Typ float dient zur Speicherung von Gleitkommazahlenl, im englischen floating point numbers (kurz floats) genannt

Das IEEE-Format interpretiert eine bestimmte Anzahl von Bits als Dezimalzahl. Es gibt hier eine kleinere Variante mit 32 Bit und eine größere Variante mit 64 Bit. Im 32 Bit Short-Format, was für das TESIVCS als Float genutzt wird, werden die Bits 0 bis 22 als Mantisse interpretiert, die Bits 23 bis 30 als Exponent und das Bit 31 als Vorzeichen.

Der Typ Ref

Ref-Variablen werden als Hexadezimalzahl dargestellt. Sie verwalten Referenzen. Während die Objekte im TESIVCS Vorlagen sind, die mit Editor ID und Form ID eindeutig gekennzeichnet sind, sind Referenzen reale Dinge in der Oblivion-Welt. Sie haben weitere Eigenschaften, hauptsächlich eine Position in der Welt.


Der Typ unsigned Integer

Neben diesen Datentypen, mit denen Variablen in der Scriptsprache deklariert und im Programm genutzt werden können, gibt es noch zwei weitere Datentypen, die im TESIVCS in Gebrauch sind. Dies sind Unsigned Integer mit 8 (0 bis 255) bzw. 16 bit (0 bis 32.767) Länge. Sie werden hauptsächlich genutzt, um Attributs- und Fähigkeitswerte zu speichern. Da sie unsigned, also vorzeichenlos sind, hat das einen auf den ersten Blick überraschenden Effekt, den sog. Ganzzahlüberlauf, der dazu führt, dass zum Beispiel ein Wert von 255 durch Addition von 2 zu 1 statt zu 257 wird.

Gültigkeitsbereiche und Lebensdauer von Variablen

Variablen sind nur in ihrem Gültigkeitsbereich bekannt und damit nutzbar. Das Bekanntmachen wird Deklaration genannt.


Scriptvariablen

Die Deklaration geschieht durch die Angabe des Variablentyps gefolgt von dem Variablennamen. <tesscript> short a long b float c ref d </tesscript>

Da ein Script nicht aus sich heraus existiert, sondern als eine Eigenschaft an Objekte (genauer die Referenzen), ausgesprochene Zauber oder Quests gebunden ist, existieren die Variablen solange, wie die in die Welt gesetzten Elemente existieren.

Eine Besonderheit sind die Variablen, die in einem Questscript deklariert werden. Ihr Gültigkeitsbereich ist global. Auf sie kann mit <tesscript>Questname.Variablenname</tesscript> von außerhalb des Questscripts zugegriffen werden.

Globale Variablen

Eine globale Variable ist für jedes Script oder Bedingung einer Referenz benutzbar, ohne dass es einen Bezug an eine einzelne Quest oder ein Objekt braucht. Um alle globalen Variablen zu sehen, mit denen man im TESIVCS arbeiten kann, wähle im Haupt-Menü "GamePlay -> Globals" und eine Liste wird dir angezeigt.

Du kannst dir auch eigene globale Variablen erstellen. Einfach in die eben erwähnte Liste rechtsklicken und "new" wählen.

  • EditorID - Der Name der Variable. Freizeichen oder Sonderzeichen sind nicht erlaubt
  • Variable Type – Es sind die Typen Short, Long und Float möglich
  • Value - Der Standard-Wert für die globale Variable

Globale Variablen werden intern im Float-Format abgelegt, aber ansonsten dem angegebenen Typ entsprechend behandelt.

Da globale Variablen an Oblivion bzw. an eine Mod gebunden sind, existieren sie "immer" bzw. so lange, wie die Mod aktiviert ist.

Game Settings

Game Settings sind keine Variablen im normalen Sinne, so wie die globalen und Script-Variablen. Sie können z.b. nicht als Ersatz für eine Zahl in einem Script verwandt werden. Auf sie kann nur mit einer Funktion GetGameSetting zugegriffen werden.

Diese Variablen existieren ebenso wie die globalen und sind auch überall zugreifbar.


Besonderheiten

Floatvariablen

Die Gleitkommaarithmetik von Float-Zahlen (oder vereinfacht ausgedrückt, das Rechnen mit Float-Zahlen) ist ein wenig gewöhnungsbedürftig, da mit diesem für Computer entwickelten Datentyp reale Zahlen nicht exakt abgebildet werden können, zumeist werden sie gerundet.


Referenzvariablen

Eine Referenzvariable kann immer dort eingesetzt werden, wo man auch eine Referenz (eines Objektes) nutzen würde. Mit Referenzvariablen kann man nicht rechnen, mit ihnen sind nur Zuweisungen und Vergleichsoperationen möglich.

Referenzen, die nicht persistent sind, sind nicht über ein Script zugreifbar, wenn das Objekt nicht im Spiel geladen ist (sich also nicht in der aktiven Zelle befindet). Auch Referenzen, die in einen Container aufgenommen werden, sind nicht zugreifbar.

Weitere Hinweise