# FolderMap.txt

FolderMap.txt
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.

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 .ocs 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.

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 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
2006-09