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. ValueData typeDescription ScenInfoArea4 integersCoordinates (x, y, width, height) of the frame displaying the scenario's description. MinResXIntegerIf 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. MinResYIntegerMinimum screen height (see MinResY). FullscreenBGIntegerIf 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.

Section [FolderMap]

ValueData typeDescription AccessStringIf 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. OverlayImageStringFilename of the image to be displayed. The file should be available in the scenario folder. Area4 integersScreen area in which to display the image. The coordinates are relative to the background image.

Any number of sections [AccessGfx]

Value Data typeDescription File StringScenario 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 StringImage to be displayed if the scenario is not selected. The image file should be available in the scenario folder. OverlayImage StringImage 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 integersScreen area in which to display the selection button. The coordinates are relative to the background image. Title StringText 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 IntegerFont size of the title. Relative to the unstretched background image. TitleColorInactive IntegerDWORD color value of the unselect button title. TitleColorActive IntegerDWORD color value of the unselect button title. TitleOffX IntegerHorizontal offset of the left aligned or centered position of the title from the left edge of the selection button. TitleOffY IntegerVertical offset of the title from the upper edge of the selection button. TitleAlign IntegerText alignment: 0 left, 1 centered, 2 right aligned. TitleUseBookFont Boolean0 or 1. If 0, the regular in-game font is used. If 1, the shadow-less font of the fullscreen menu is used.

Any number of sections [Scenario]

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: ResolutionSize of the folder map. 640x480616x385 800x600768x480 1024x768984x616 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 OpenClonk.log. Sven22006-09