Switch: Unterschied zwischen den Versionen

Aus AntamarWiki
Wechseln zu: Navigation, Suche
K
 
(20 dazwischenliegende Versionen von 12 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
Das '''<switch>'''-Tag vergleicht eine Angabe mit einer Liste von Werten. Der Zweig mit dem passenden Wert wird ausgeführt.
 
Das '''<switch>'''-Tag vergleicht eine Angabe mit einer Liste von Werten. Der Zweig mit dem passenden Wert wird ausgeführt.
 +
 +
Der gesamte '''<switch>'''-Tag sieht wir folgt aus:
 +
<syntaxhighlight lang="xml">
 +
<switch attribute|name="">
 +
  <null>
 +
  </null>
 +
 +
  <case ...>
 +
  </case>
 +
 +
  <case ...>
 +
  </case>
 +
 +
  <else>
 +
  </else>
 +
</switch>
 +
</syntaxhighlight>
 +
 +
<br>'''NULL''' wird ausgeführt wenn der Inhalt von NAME oder ATTRIBUTE leer ist.
 +
<br>'''CASE''' wird benutzt, um bestimmte Werte oder Wertebereiche zu prüfen. Hier kann zum Beispiel VAL, MIN oder MAX benutzt werden.
 +
<br>'''ELSE''' wird ausgeführt, wenn die vorherigen Angaben nicht passen.
 +
 +
<br>Tipp:
 +
<br>Wenn eine Variable mit 0 gesetzt wird, muss sie wie folgt abgefragt werden.
 +
<syntaxhighlight lang="xml">
 +
<store name="test" scope="...">0</store> <!-- gesetzte Variable -->
 +
 +
<switch name="test">
 +
  <null>...</null> <!-- hat hier keine Auswirkung -->
 +
  <case val="0">...</case> <!-- wird in dem Fall ausgeführt -->
 +
  <else>...</else> <!-- bei ungleich 0 -->
 +
</switch>
 +
</syntaxhighlight>
 +
 
Beispiel:
 
Beispiel:
<code xml>
+
<syntaxhighlight lang="xml">
<switch quality="gender">
+
<switch attribute="gender">
 
   <case value="female">Eine junge Frau</case>
 
   <case value="female">Eine junge Frau</case>
 
   <else>Ein junger Mann</else>
 
   <else>Ein junger Mann</else>
 
</switch>
 
</switch>
</code>
+
</syntaxhighlight>
Der Zweig '''<else>''' wird ausgeführt, wenn keine der Angaben passt.
+
Der Zweig '''<else>''' wird ausgeführt, wenn das Geschlecht nicht weiblich ist.
 +
 
 +
 
 +
Eine Liste der Attribute zur Verwendung mit dem '''attribute''' Tag gibt's hier: [[Heldattribute]]
  
Eine Liste der Attribute gibt's hier: [[AOQML-Manual#Attribute|Attribute]]
+
Außerdem können mit dem '''name''' Tag die selben Variablen wie bei [[Set]] abgefragt werden.
  
  
 
Man kann auch Wertebereiche abfragen:
 
Man kann auch Wertebereiche abfragen:
<code xml>
+
<syntaxhighlight lang="xml">
 +
<switch name="Nummer">
 +
  <case min="1" max="5">
 +
    ...
 +
  </case>
 +
  <else>
 +
    ...
 +
  </else>
 +
</switch>
 +
</syntaxhighlight>
 +
 
 +
==Wahrscheinlichkeits Zweig==
 +
 
 +
Um für ein Ereignis/Zweig die Wahrscheinlichkeit anzugeben müssen wir erst per [[Get_set|Set]] und einem [[Besondere_Werte#Zahlenbereiche|besonderen Wert]] eine zufällige Zahl in einer Variablen speichern (im Beispiel ''zufall'')
 +
und diese dann per switch prüfen.
 +
 
 +
Beispiel:
 +
<syntaxhighlight lang="xml">
 +
<set name="zufall" val="1...100" show="none"/>
 
<switch name="zufall">
 
<switch name="zufall">
   <case min="1" max="5">
+
   <case min="1" max="25">
 +
    ...
 +
  </case>
 +
  <case min="26" max="65">
 
     ...
 
     ...
 
   </case>
 
   </case>
Zeile 22: Zeile 80:
 
   </else>
 
   </else>
 
</switch>
 
</switch>
</code>
+
</syntaxhighlight>
Liegt der Wert der Variable "zufall" bei 1 bis 5, wird der erste <case> ausgewertet, andernfalls der <else>-Zweig. Um einen zufälligen Wert zu erzeugen, gibt es den Operator "...". Das funktioniert z. B. so:
+
Das Beispiel führt zu einer 25% igen Wahrscheinlichkeit den ersten Zweig aus, zu 40% den Zweiten und somit zu 35% den else-Zweig.
<code xml>
+
 
<set name="zufall" value="1...20"/>
+
==Generische Variablenauswertung im Casezweig==
</code>
+
Um flexiblere Quests aufzubauen, dürfen auch Variablennamen durch Verwendung des name-Attributs ausgewertet werden.
Damit wird ein Zufallswert von 1 bis 20 in der Variablen "zufall" gespeichert.
+
 
 +
===Beispiel===
 +
Szene 1:
 +
<syntaxhighlight lang="xml">
 +
<random>
 +
  <case> <store name="source">Eisentrutz</store> </case>
 +
  <case> <store name="source">Berenhavn</store> </case>
 +
  <case> <store name="source">Tamelsquell</store> </case>
 +
</random>
 +
</syntaxhighlight>
 +
 
 +
Szene 2:
 +
<syntaxhighlight lang="xml">
 +
<switch attribute="site">
 +
  <case name="${source}"><include target="atSourceLocation"/></case>
 +
  <else><quest status="pending"/></else>
 +
</switch>
 +
</syntaxhighlight>
  
[[Kategorie:AOQML]]
+
[[Kategorie:AOQML-Tags]]

Aktuelle Version vom 1. Oktober 2017, 23:22 Uhr

Das <switch>-Tag vergleicht eine Angabe mit einer Liste von Werten. Der Zweig mit dem passenden Wert wird ausgeführt.

Der gesamte <switch>-Tag sieht wir folgt aus:

<switch attribute|name="">
  <null>
  </null>

  <case ...>
  </case>

  <case ...>
  </case>

  <else>
  </else>
</switch>


NULL wird ausgeführt wenn der Inhalt von NAME oder ATTRIBUTE leer ist.
CASE wird benutzt, um bestimmte Werte oder Wertebereiche zu prüfen. Hier kann zum Beispiel VAL, MIN oder MAX benutzt werden.
ELSE wird ausgeführt, wenn die vorherigen Angaben nicht passen.


Tipp:
Wenn eine Variable mit 0 gesetzt wird, muss sie wie folgt abgefragt werden.

<store name="test" scope="...">0</store> <!-- gesetzte Variable -->

<switch name="test">
  <null>...</null> <!-- hat hier keine Auswirkung -->
  <case val="0">...</case> <!-- wird in dem Fall ausgeführt -->
  <else>...</else> <!-- bei ungleich 0 -->
</switch>

Beispiel:

<switch attribute="gender">
  <case value="female">Eine junge Frau</case>
  <else>Ein junger Mann</else>
</switch>

Der Zweig <else> wird ausgeführt, wenn das Geschlecht nicht weiblich ist.


Eine Liste der Attribute zur Verwendung mit dem attribute Tag gibt's hier: Heldattribute

Außerdem können mit dem name Tag die selben Variablen wie bei Set abgefragt werden.


Man kann auch Wertebereiche abfragen:

<switch name="Nummer">
  <case min="1" max="5">
    ...
  </case>
  <else>
    ...
  </else>
</switch>

Wahrscheinlichkeits Zweig

Um für ein Ereignis/Zweig die Wahrscheinlichkeit anzugeben müssen wir erst per Set und einem besonderen Wert eine zufällige Zahl in einer Variablen speichern (im Beispiel zufall) und diese dann per switch prüfen.

Beispiel:

<set name="zufall" val="1...100" show="none"/>
<switch name="zufall">
  <case min="1" max="25">
    ...
  </case>
  <case min="26" max="65">
    ...
  </case>
  <else>
    ...
  </else>
</switch>

Das Beispiel führt zu einer 25% igen Wahrscheinlichkeit den ersten Zweig aus, zu 40% den Zweiten und somit zu 35% den else-Zweig.

Generische Variablenauswertung im Casezweig

Um flexiblere Quests aufzubauen, dürfen auch Variablennamen durch Verwendung des name-Attributs ausgewertet werden.

Beispiel

Szene 1:

<random>
  <case> <store name="source">Eisentrutz</store> </case>
  <case> <store name="source">Berenhavn</store> </case>
  <case> <store name="source">Tamelsquell</store> </case>
</random>

Szene 2:

<switch attribute="site">
  <case name="${source}"><include target="atSourceLocation"/></case>
  <else><quest status="pending"/></else>
</switch>