FolderMap.txt

Ab CR können Rundenordner Auswahlkarten für die enthaltenen Szenarien anbieten. Diese Karten werden nur in der Szenarienauswahl im Spiel und nicht im Entwicklerfrontend (Editor) angezeigt. Für ein Beispiel siehe das Westernpack von RedWolf Design.
Sektion [FolderMap]
Wert Datentyp Beschreibung
ScenInfoArea 4 Integer Koordinaten (x,y,Breite,Höhe) für die Beschreibungsbox, in der die Beschreibung für das ausgewählte Szenario angezeigt wird.
MinResX Integer Unterschreitet die Bildschirmauflösung des Spielers diesen Wert in der Breite, so wird statt der FolderMap die klassische Szenarienauswahl angezeigt. Dies ist nützlich, falls die Karte so großräumig ausgelegt ist, dass sie bei kleineren Auflösungen unbenutzbar wäre.
MinResY Integer Analog zu MinResY: Mindesthöhe der Bildschirmauflösung.
FullscreenBG Integer Wenn ungleich 0, wird das Hintergrundbild auf die gesamte Bildschirmgröße gestreckt. Dabei ist zu beachten, dass Kontrollelemente trotzdem nur innerhalb des mittleren Gebietes platziert werden dürfen.
HideTitle Boolean Falls true, wird die Überschrift "Spiel starten" am oberen Rand ausgeblendet.
Beliebig viele Sektionen [AccessGfx]
Wert Datentyp Beschreibung
Access Zeichenfolge Wenn für diesen Benutzer das hier angegebene MissionAccess-Passwort freigeschaltet ist, wird die in dieser Sektion beschriebene Grafik auf der FolderMap angezeigt. Auf diese Weise können einzelne Bestandteile der Karte freigespielt werden. Siehe dazu die Scriptfunktion GainMissionAccess.
OverlayImage Zeichenfolge Dateiname der Grafikdatei, die angezeigt wird. Die Datei sollte im selben Rundenordner liegen.
Area 4 Integer Koordinaten des Bereiches, in dem das Bild angezeigt wird. Die Koordinaten sind relativ zum Hintergrundbild.
Beliebig viele Sektionen [Scenario]
Wert Datentyp Beschreibung
File Zeichenfolge Szenariendatei (inklusive Endung .c4s), für die mit dieser Sektion ein Knopf erstellt wird. Für jedes Szenario im Rundenordner sollte eine [Scenario]-Sektion erstellt werden. Es werden grundsätzlich nur die Knöpfe angezeigt, für die der Benutzer MissionAccess (siehe GainMissionAccess) freigeschaltet hat.
BaseImage Zeichenfolge Dateiname der Grafikdatei, die angezeigt wird, wenn das Szenario nicht ausgewählt ist. Die Datei sollte im selben Rundenordner liegen.
OverlayImage Zeichenfolge Dateiname der Grafikdatei, die angezeigt wird, wenn der Benutzer das Szenario ausgewählt hat oder mit der Maus darüber fährt. Die Datei sollte im selben Rundenordner liegen.
Area 4 Integer Koordinaten des Bereiches, in dem der Knopf angezeigt wird. Die Koordinaten sind relativ zum Hintergrundbild.
Title Zeichenfolge Titel, der auf den Knopf geschrieben wird. Für Szenarientitel, die in allen Sprachen gleich sind, kann der Titel auch weggelassen und stattdessen direkt ins BaseImage bzw. Overlayimage gemalt werden. Die Zeichenkette TITLE wird dabei automatisch durch den aus dem Szenario geladenen Titel ersetzt.
TitleFontSize Integer Schriftgröße des Titels. Die Größe bezieht sich auf ein nicht gezoomtes Hintergrundbild und kann je nach Auflösung verändert werden.
TitleColorInactive Integer DWORD-Farbe des Titels, wenn der Knopf nicht ausgewählt ist.
TitleColorActive Integer DWORD-Farbe des Titels, wenn der Knopf nicht sgewählt ist.
TitleOffX Integer Horizontaler Offset der linken Kante (bzw. Textmitte bei zentriertem Text) des Titels von der linken Kante des Knopfes.
TitleOffY Integer Vertikaler Offset der Oberkante des Titels von der oberen Kante des Knopfes.
TitleAlign Integer Ausrichtung des Titels: 0 für linksbündig, 1 für zentriert, 2 für rechtsbündig.
TitleUseBookFont Boolean 0 oder 1. Bei 1 wird die schattenlose Schriftart des Startupmenüs anstatt der nromalen InGame-Schriftart für den Titelverwendet.
SingleClick Boolean Falls true, wird der Eintrag bereits bei Einzelklick gestartet/geöffnet.

Anordnung der Elemente

Es werden grundsätzlich alle AccessGfx-Grafiken unter die Szenarienknöpfe gezeichnet. Die Szenarienknöpfe erscheinen in der Reihenfolge, in der sie in der Datei angegeben sind. Dabei ist darauf zu achten, dass man sie in einer sinnvollen Reihenfolge angibt (also von links nach rechts und von oben nach unten), da das Durchschalten mit Tastatur oder Gamepad hiervon abhängt. Es ist auch Aufgabe des Entwicklers, dafür zu sorgen, dass sich Knöpfe und Grafiken nicht überlappen.

Hintergrundbild

Wenn der Ordner eine FolderMap enthält, wird eine der Bilddateien FolderMap.png/.jpg/.jpeg/.bmp als Hintergrund erwartet. Die optimale Bildgröße, bei der das Hintergrundbild ohne gestreckt zu werden angezeigt werden kann, hängt von der Bildschirmauflösung des Benutzers ab:
Auflösung Größe der FolderMap
640x480 616x385
800x600 768x480
1024x768 984x616
Das Bild wird immer auf die volle, für die Auswahl zur Verfügung stehende Größe gestreckt bzw. gestaucht. Alle Positionsangaben für Szenarien, die Beschreibungsleiste, etc. beziehen sich auf Koordinaten in diesem Hintergrundbild und werden entsprechend mitgestreckt oder gestaucht. Es empfiehlt sich also, die Karte für eine relativ große Auflösung wie z.B. 1024x768 zu gestalten, und stets zu testen, ob für kleine Auflösungen noch alles lesbar ist.

Tipps zur Entwicklung

Zum Testen kann die FolderMap mit einem entpackten Rundenordner entworfen, und dann in der Szenarienauswahl mit Druck auf F5 jeweils neu geladen werden. Erscheint statt der FolderMap die klassische Szenarienauswahl, ist beim Laden der Definitionsdatei ein Fehler aufgetreten, oder zum Beispiel eine referenzierte Grafikdatei nicht gefunden worden. Bei aktiviertem Debugmodus findet sich in dem Fall eine Fehlermeldung in der Datei Clonk.log.
Sven2, September 2006