FolderMap.txt

From CR, scenario folders can also contain graphical folder maps for the selection of scenarios. These will be displayed only in the fullscreen menu, not in the editor. See the Western pack for samples.
Section [FolderMap]
Value Data type Description
ScenInfoArea 4 integers Coordinates (x, y, width, height) of the frame displaying the scenario's description.
MinResX Integer If the current screen resolution width is less than this value, the folder map is not displayed and classic scenario selection is used. This is useful if your graphical map is high resolution and might turn out unuseable in lower resolutions.
MinResY Integer Minimum screen height (see MinResY).
FullscreenBG Integer If not 0, the background image is stretched to full screen size. Notice that button controls may still only be placed in the inner area of the map.
HideTitle Boolean Hides the title "Start game" at the top if true.
Any number of sections [AccessGfx]
Value Data type Description
Access String If the player has gained the specified MissionAccess password, the graphical element specified in this section is displayed. This can be used to give access to certain scenarios only after other scenarios have been completed. See GainMissionAccess.
OverlayImage String Filename of the image to be displayed. The file should be available in the scenario folder.
Area 4 integers Screen area in which to display the image. The coordinates are relative to the background image.
Any number of sections [Scenario]
Value Data type Description
File String Scenario file (including .c4s extension) to be started by this section. You should create a [Scenario] section for each scenario in the scenario folder. Only those scenario sections are displayed for which MissionAccess (see GainMissionAccess) is displayed.
BaseImage String Image to be displayed if the scenario is not selected. The image file should be available in the scenario folder.
OverlayImage String Image to be displayed if the scenario is selected or hovered over with the mouse. The image file should be available in the scenario folder.
Area 4 integers Screen area in which to display the selection button. The coordinates are relative to the background image.
Title String Text to be displayed on the selection button. If no localization is needed, you can also integrate the text directly into the base image or overlay image. If you specify the string TITLE, the localized title is loaded from the corresponding scenario.
TitleFontSize Integer Font size of the title. Relative to the unstretched background image.
TitleColorInactive Integer DWORD color value of the unselect button title.
TitleColorActive Integer DWORD color value of the unselect button title.
TitleOffX Integer Horizontal offset of the left aligned or centered position of the title from the left edge of the selection button.
TitleOffY Integer Vertical offset of the title from the upper edge of the selection button.
TitleAlign Integer Text alignment: 0 left, 1 centered, 2 right aligned.
TitleUseBookFont Boolean 0 or 1. If 0, the regular in-game font is used. If 1, the shadow-less font of the fullscreen menu is used.
SingleClick Boolean If true the entry is started/opened using a single click instead of double click.

Element Order

AccessGfx images drawn under the scenario selection buttons. Selection buttons appear in the order in which they are specified in the file. Thus you should specifiy sections in a meaningful order, from left to right and top to bottom as this will affect the tab stepping sequence when controlling the dialog with the keyboard or gamepad. Also, you should take care not to overlap any buttons.

Background image

If the scenario folder contains a folder map, an image file of name FolderMap.png/.jpg/.jpeg/.bmp is expected. The recommended size of this image depends on the screen resolution of the end user:
Resolution Size of the folder map.
640x480 616x385
800x600 768x480
1024x768 984x616
The image is always stretched to the full available screen area. All coordinates given for section elements are relative to the unstretched background image.

Useful Hints

For testing purposes a folder map can be loaded from an unpacked scenario folder and reloaded an runtime using F5. If the classic scenario selection appears instead of the folder map, an error has occured in the folder map declaration, such as missing image files. With debug mode activated, there will also be an error message in Clonk.log.
Sven2, September 2006