FolderMap.txt

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.