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.

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.

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.

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 OpenClonk.log.