Cattle and Crops: Mission Documentation


condition/window

Während der Condition-Text nur eine kurze Zeile ist, kann parallel per <window> ein längerer Text angezeigt werden, der scrollbar ist. Das Text-Fenster wird geschlossen sobald die Condition erfüllt ist, oder der User manuell das Fenster schließt. stringId verweist auf den Translation-Eintrag in der stringTable. Der Content von <window> dient als Fallback, falls der StringTable-Eintrag nicht gefunden wird.

Ein <window> kann in seiner einfachsten Form einen simplen Text haben. Es ist aber auch stark erweitert zu nutzen:

  • mehrere blätterbare Seiten (<page>)
  • verschiedene Größen (size)
  • verschiedene Positionen (position)
    • default: rechts neben dem Schritt-Text
    • center: absolut mittig im Fenster
    • centerTop: horizontal mittig im Fenster, vertikal 20px von der Oberkante
    • rightCenter: horizontal 20px von der rechten Fensterkante, vertikal mittig im Fenster
    • rightTop: horizontal 20px von der rechten Fensterkante, vertikal 20px von der Oberkante
    • rightUnderCondition: horizontal 20px von der rechten Fensterkante, vertikal direkt unterhalb des Schritt-Textes
    • underCondition: horizontal an der linken Fensterkante, vertikal direkt unterhalb des Schritt-Textes
  • mehrere Content-Elemente (<element>) wie Text oder Bild innerhalb einer <page>
    • Es können per type="panel" panel="myPanelName" custom Elemente definiert werden, deren Inhalt nicht verarbeitet wird, wie z.B. Separatoren oder Abstände. Der benötigte Panel-Dateiname baut sich aus missionConditionWindow-element-[panel]-[size].pan zusammen.
  • Bilder werden kleinskaliert um in das Fenster zu passen, aber nicht hochskaliert wenn sie kleiner als die Fensterbreite sind

Zusammen mit der Condition infoWindow kann <window> als Einleitungs-, Zwischen- oder Abschlussfenster benutzt werden das keine gesonderten Schritte des Users außer lesen erfordert.


Attribute

Attribute Type Value Beschreibung
stringId string * StringId des Textes. Nur nötig wenn keine <element>s benutzt werden.
(hideTitle) boolean true | false Optional: Wenn true wird der Schritt-Text im Titel ausgeblendet.
Default: false
(size) string small | medium | large | underCondition | underCondition250 | underCondition300 Optional: Größe des Fensters. Default: small
(position) string default | center | centerTop | rightCenter | rightTop | rightUnderCondition | underCondition Optional: Fenster-Position (Beschreibungen s.o.). Default: default
(gamepad) boolean true | false Optional: Wenn true wird das window nur angezeigt wenn ein Gamepad aktiviert ist. Es muss dann ein weiteres <window> mit gamepad="false" wird für nicht-Gamepad-User definiert sein.
Default: false
(title) string * Optional: Überschreibt die Condition-Description im Titel des Windows mit einem separaten Titels. Fallback zu titleStringId
(titleStringId) string * Optional: StringId des custom Titels.

Page/Element-System: Attribute

page
Attribute Type Value Beschreibung
showContinue boolean true | false Wenn true, wird an der Unterseite des Fensters ein "Weiter"-Button angezeigt, der dieselbe Funktion wie der Schließen-Button hat.
Default: false
element
Attribute Type Value Beschreibung
type string text | image | panel Der Element-Typ.
Wenn image, muss auch das image-Attribut gesetzt sein.
Wenn panel, muss auch das panel-Attribut gesetzt sein.
stringId string * StringId des Textes. Nur wenn type="text"
image string [path/to/image] Pfad zum Grafik. Nur wenn type="image"
align string left | center | right Horizontales Alignment der Grafik. Nur wenn type="image"
Default: center
panel string * Name der Panel-Datei. Nur wenn type="panel"

Beispiel

<conditions>
    <!-- Einfaches Fenster mit Standard-Einstellungen -->
    <condition ...>
        <window stringId="MISS-STP1-INFO">This is the fallback text</window>
    </condition>

    <!-- Erweitertes Fenster mit mehreren Seiten und Content-Elementen, einer custom Position und custom Größe -->
    <condition ...>
        <window size="medium" position="center" hideTitle="true">
            <page>
                <element type="text" stringId="MISS-ASDF-TXT1">Fallback Text 1</element>
                <element type="image" image="path/to/image" align="right" />
                <element type="text" stringId="MISS-ASDF-TXT2">Fallback Text 2</element>
            </page>
            <page>
                <element type="image" image="path/to/another/image" />
                <element type="panel" panel="separator" /> <!-- verweist auf "missionConditionWindow-element-separator-medium.pan" -->
                <element type="text" stringId="MISS-ASDF-TXT3">Fallback Text 3</element>
            </page>
            <page showContinue="true">
                <element type="text" stringId="MISS-ASDF-TXT4">Fallback Text 4</element>
            </page>
        </window>

        <!-- Alternativ-Fenster für Gamepad -->
        <window size="medium" gamepad="true" position="center" hideTitle="true">
            <page>
                <element type="text" stringId="MISS-ASDF-TXT0">Mein Gamepad-spezifischer Text</element>
            </page>
        </window>
    </condition>
</conditions>

results matching ""

    No results matching ""