Dynamic Map Generator - Revision history

Newton: /* Dynamic Map Generator */

2014-08-09T16:41:41Z

Dynamic Map Generator

← Older revision		Revision as of 16:41, 9 August 2014
Line 1:		Line 1:
	== Dynamic Map Generator ==		== Dynamic Map Generator ==

	OpenClonk has a dynamic map generator that can be used to generate maps that look different everytime but still have specified recurring patterns, like lava ~~likes~~, mountains, or sky islands. The documentation is available in the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html C4Script reference here].		OpenClonk has a dynamic map generator that can be used to generate maps that look different everytime but still have specified recurring patterns, like lava lakes, mountains, or sky islands. The documentation is available in the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html C4Script reference here].
	Mape is used to edit and display Landscape.txts~~, it doesn't support~~ Map.c.		Mape is used to edit and display both Landscape.txts and Map.c.

	=== Mape ===		=== Mape ===

Newton: add note about Map.c

2014-01-26T07:11:50Z

add note about Map.c

← Older revision		Revision as of 07:11, 26 January 2014
Line 2:		Line 2:

	OpenClonk has a dynamic map generator that can be used to generate maps that look different everytime but still have specified recurring patterns, like lava likes, mountains, or sky islands. The documentation is available in the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html C4Script reference here].		OpenClonk has a dynamic map generator that can be used to generate maps that look different everytime but still have specified recurring patterns, like lava likes, mountains, or sky islands. The documentation is available in the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html C4Script reference here].
			Mape is used to edit and display Landscape.txts, it doesn't support Map.c.

	=== Mape ===		=== Mape ===

Clonk-Karl: Update for mape being available as development snapshots

2013-01-26T18:21:19Z

Update for mape being available as development snapshots

← Older revision		Revision as of 18:21, 26 January 2013
Line 7:		Line 7:
	[[File:Mape.png\|450px\|border\|right\|Screenshot of Mape]]		[[File:Mape.png\|450px\|border\|right\|Screenshot of Mape]]

	Mape is a tool that shows a live preview of the generated mape as the Landscape.txt code is being typed. ~~Currently, the~~ tool is available in [http://~~git~~.openclonk.org/~~ck/openclonk.git~~/~~shortlog/refs/heads/mape ck's experimental git repository~~]. ~~I plan to merge it into~~ the ~~official~~ OpenClonk repository ~~soon and to provide development snapshots of it~~.		Mape is a tool that shows a live preview of the generated mape as the Landscape.txt code is being typed. The tool is available from the [http://www.openclonk.org/nightly-builds/ Development Snapshots] page for all major platforms. Its source code lives in the OpenClonk git repository.

	The tool is meant both for beginners and experts alike. Beginners can easily play around with all the possibilities and immediately see their effect on the generated map. Experts can easily tweak the map to their liking without having to restart the engine for every change they make.		The tool is meant both for beginners and experts alike. Beginners can easily play around with all the possibilities and immediately see their effect on the generated map. Experts can easily tweak the map to their liking without having to restart the engine for every change they make.
Line 23:		Line 23:
	* For big maps, rendering the map can take a while, up to a few seconds. This considerably slows down the feedback one gets for changing little things here and there. In this case, one can comment out the parts of the map that one does not work on right now and concentrate only on one specific feature or aspect of it, and then put it all together in the end.		* For big maps, rendering the map can take a while, up to a few seconds. This considerably slows down the feedback one gets for changing little things here and there. In this case, one can comment out the parts of the map that one does not work on right now and concentrate only on one specific feature or aspect of it, and then put it all together in the end.

	* For overlays that use algo=script, the Script.c file that contains the script function that is being evaluated by the algorithm needs to be in the same directory as the Landscape.txt file. Therefore the Landscape.txt file must be saved at least once before algo=script can be used, so that mape knows where to look for the Script.c file. The landscape preview does not update automatically when the Script.c file is changed, but a ~~simply~~ click on it re-generates it.		* For overlays that use algo=script, the Script.c file that contains the script function that is being evaluated by the algorithm needs to be in the same directory as the Landscape.txt file. Therefore the Landscape.txt file must be saved at least once before algo=script can be used, so that mape knows where to look for the Script.c file. The landscape preview does not update automatically when the Script.c file is changed, but a simple click on it re-generates it.

	=== Bug Reports and Feature Requests ===		=== Bug Reports and Feature Requests ===

	~~For now, send bug reports~~ and ~~feature requests to me via~~ the ~~forum or IRC~~. ~~If and when this gets included in the official OpenClonk repository I plan to create~~ a category ~~in the bugtracker~~ for it.		Bug Reports and Feature Requests can be reported in the [http://bugs.openclonk.org bug tracker]. There is a category for mape.

Clonk-Karl: Add a screenshot

2013-01-12T15:42:17Z

Add a screenshot

← Older revision		Revision as of 15:42, 12 January 2013
Line 4:		Line 4:

	=== Mape ===		=== Mape ===

			[[File:Mape.png\|450px\|border\|right\|Screenshot of Mape]]

	Mape is a tool that shows a live preview of the generated mape as the Landscape.txt code is being typed. Currently, the tool is available in [http://git.openclonk.org/ck/openclonk.git/shortlog/refs/heads/mape ck's experimental git repository]. I plan to merge it into the official OpenClonk repository soon and to provide development snapshots of it.		Mape is a tool that shows a live preview of the generated mape as the Landscape.txt code is being typed. Currently, the tool is available in [http://git.openclonk.org/ck/openclonk.git/shortlog/refs/heads/mape ck's experimental git repository]. I plan to merge it into the official OpenClonk repository soon and to provide development snapshots of it.

Clonk-Karl: Add some brief documentation for mape

2013-01-12T15:32:46Z

Add some brief documentation for mape

New page

== Dynamic Map Generator ==

OpenClonk has a dynamic map generator that can be used to generate maps that look different everytime but still have specified recurring patterns, like lava likes, mountains, or sky islands. The documentation is available in the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html C4Script reference here].

=== Mape ===

Mape is a tool that shows a live preview of the generated mape as the Landscape.txt code is being typed. Currently, the tool is available in [http://git.openclonk.org/ck/openclonk.git/shortlog/refs/heads/mape ck's experimental git repository]. I plan to merge it into the official OpenClonk repository soon and to provide development snapshots of it.

The tool is meant both for beginners and experts alike. Beginners can easily play around with all the possibilities and immediately see their effect on the generated map. Experts can easily tweak the map to their liking without having to restart the engine for every change they make.

The mape window has four panels. The upper right part is the largest one which is where the Landscape.txt code can be edited. The panel to the left of it shows the file system tree. This is where one can select the Material.ocg file to be loaded. This specifies the materials and textures available to the map generator. The loaded materials and textures can be seen at the bottom panel once loaded which provides an easy view to what materials and textures are available. Finally in the lower right corner there is a preview of the generated map which updates as one types. The status bar contains error messages from the Landscape generator in case the Landscape.txt code is not correct.

=== Tips and Tricks ===

* The options allow to specify the width and height of the generated mape. To avoid any surprises, especially when specifying parameters with pixels instead of percentages, this should always be set to the same size as the OpenClonk map that one plans to create.

* In the options there is also the possibility to use a fixed seed for the random number generator. This allows to always create the same map when using the same Landscape.txt code, even if it contains randomness. This can come handy when trying to get a part of the map right and one does not want the rest of the map to change with every keystroke.

* If the random seed is not fixed, the map preview can be clicked on to generate another version of the map using the same Landscape.txt code but the randomness is re-evaluated.

* For big maps, rendering the map can take a while, up to a few seconds. This considerably slows down the feedback one gets for changing little things here and there. In this case, one can comment out the parts of the map that one does not work on right now and concentrate only on one specific feature or aspect of it, and then put it all together in the end.

* For overlays that use algo=script, the Script.c file that contains the script function that is being evaluated by the algorithm needs to be in the same directory as the Landscape.txt file. Therefore the Landscape.txt file must be saved at least once before algo=script can be used, so that mape knows where to look for the Script.c file. The landscape preview does not update automatically when the Script.c file is changed, but a simply click on it re-generates it.

=== Bug Reports and Feature Requests ===

For now, send bug reports and feature requests to me via the forum or IRC. If and when this gets included in the official OpenClonk repository I plan to create a category in the bugtracker for it.