Tutorial: Map Generator - Special Features - Revision history

Maikel at 16:21, 22 January 2011

2011-01-22T16:21:13Z

← Older revision		Revision as of 16:21, 22 January 2011
Line 2:		Line 2:

	==Template overlays==		==Template overlays==

	[TODO: Describe how to use overlays as templates.]		[TODO: Describe how to use overlays as templates.]

			==Polygon algorithm==

			[TODO: Describe the polygon algorithm]

	==Algorithms In C4Script==		==Algorithms In C4Script==

Maikel: /* Multiple Maps */

2011-01-22T16:18:54Z

Multiple Maps

← Older revision		Revision as of 16:18, 22 January 2011
Line 44:		Line 44:
	==Multiple Maps==		==Multiple Maps==

	[TODO: explain DrawDefMap and KeepMapCreator]		[TODO: explain DrawDefMap and KeepMapCreator and rndall algorithm, for loading multiple and/or random maps]

	map Map1 {		map Map1 {

Maikel: /* Defining overlays outside of a map */

2011-01-21T22:49:45Z

Defining overlays outside of a map

← Older revision		Revision as of 22:49, 21 January 2011
Line 1:		Line 1:
	This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|'''here''']], but only part [[Tutorial:_Map_Generator_-_The_Basics\|'''one''']] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|'''two''']] are prerequisites for this tutorials. This tutorial discusses some features of the map generator that do not fit into distinct categories.		This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|'''here''']], but only part [[Tutorial:_Map_Generator_-_The_Basics\|'''one''']] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|'''two''']] are prerequisites for this tutorials. This tutorial discusses some features of the map generator that do not fit into distinct categories.

	==~~Defining~~ overlays ~~outside of a map~~==		==Template overlays==
			[TODO: Describe how to use overlays as templates.]

	==Algorithms In C4Script==		==Algorithms In C4Script==

Maikel at 22:23, 20 January 2011

2011-01-20T22:23:27Z

← Older revision		Revision as of 22:23, 20 January 2011
Line 72:		Line 72:

	By completing this tutorial you know all features of the map generator. The only thing left is to create good looking, dynamic and playable maps. Therefore the last [[Tutorial: Map Generator - Complete Landscapes\|'''part''']] of this tutorial contains some examples about actual playable landscapes.		By completing this tutorial you know all features of the map generator. The only thing left is to create good looking, dynamic and playable maps. Therefore the last [[Tutorial: Map Generator - Complete Landscapes\|'''part''']] of this tutorial contains some examples about actual playable landscapes.

			[[Category:Map Generator Tutorials]]

Maikel: /* Algorithms In C4Script */

2011-01-20T18:48:57Z

Algorithms In C4Script

← Older revision		Revision as of 18:48, 20 January 2011
Line 7:		Line 7:

	[[File:MapGenerator_ExampleScriptAlgorithm.png\|200px\|thumb\|right\|A golden ellipse with rock border.]]		[[File:MapGenerator_ExampleScriptAlgorithm.png\|200px\|thumb\|right\|A golden ellipse with rock border.]]
	A first look at the landscape on the right might make you wonder, how is this created? A quick look into the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html#Algos list] of algorithms will convince you that there is no ellipse neither a circle that can be transformed into an ellipse. The trick here is that you can define your own algorithms in C4Script, by using the <code>script</code> algorithm. Producing decent ~~algorithm~~ might need some mathematical skills as we will see in this example. Leaving the rock border aside for now, we'll focus on the algorithm to create an ellipse first. From the documentation we find that the algorithm must be defined in the scenario script, where the following function is called.		A first look at the landscape on the right might make you wonder, how is this created? A quick look into the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html#Algos list] of algorithms will convince you that there is no ellipse neither a circle that can be transformed into an ellipse. The trick here is that you can define your own algorithms in C4Script, by using the <code>script</code> algorithm. Producing decent algorithms might need some mathematical skills as we will see in this example. Leaving the rock border aside for now, we'll focus on the algorithm to create an ellipse first. From the documentation we find that the algorithm must be defined in the scenario script, where the following function is called.
	func ScriptAlgo[Overlay-Name](int x, int y, int a, int b)		func ScriptAlgo[Overlay-Name](int x, int y, int a, int b)
	In this function <code>x</code> and <code>y</code> are the pixel coordinates for which the function is called and <code>a, b</code> are the usual parameters. The function should return <code>true</code> if a pixel is to be drawn and <code>false</code> if not. So for our map of <code>MapWidth = MapHeight = 100</code>, <code>x</code> and <code>y</code> range from 0 to 10000. First we scale <code>x</code> and <code>y</code> to normal coordinates and shift them to the middle of the map.Then let <code>a</code> represent the major axis of an ellipse and <code>b</code> the minor axis, see [http://en.wikipedia.org/wiki/Ellipse wikipedia]. Using the canonical form to describe an ellipse we can create the needed ellipse algorithm, it is:		In this function <code>x</code> and <code>y</code> are the pixel coordinates for which the function is called and <code>a, b</code> are the usual parameters. The function should return <code>true</code> if a pixel is to be drawn and <code>false</code> if not. So for our map of <code>MapWidth = MapHeight = 100</code>, <code>x</code> and <code>y</code> range from 0 to 10000. First we scale <code>x</code> and <code>y</code> to normal coordinates and shift them to the middle of the map.Then let <code>a</code> represent the major axis of an ellipse and <code>b</code> the minor axis, see [http://en.wikipedia.org/wiki/Ellipse wikipedia]. Using the canonical form to describe an ellipse we can create the needed ellipse algorithm, it is:

Maikel: /* Defining multiple maps and loading them */

2010-12-12T19:03:31Z

Defining multiple maps and loading them

@@ Line 42: / Line 42: @@
 To create the rock border we need another special algorithm, which is the <code>border</code> algorithm. This draws an inner border in the parent layer, <code>a</code> and <code>b</code> respectively specify the horizontal and vertical width of the border. This completes the example, as a little exercise you can try to draw a circle half out of gold and half out of rock.
-==Defining multiple maps and loading them==
+==Multiple Maps==
 ==Exercise==

Maikel at 18:41, 12 December 2010

2010-12-12T18:41:18Z

← Older revision		Revision as of 18:41, 12 December 2010
Line 1:		Line 1:
	This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|here]], but only part [[Tutorial:_Map_Generator_-_The_Basics\|one]] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|two]] are prerequisites for this tutorials. This tutorial discusses some features of the map generator that do not fit into distinct categories.		This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|'''here''']], but only part [[Tutorial:_Map_Generator_-_The_Basics\|'''one''']] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|'''two''']] are prerequisites for this tutorials. This tutorial discusses some features of the map generator that do not fit into distinct categories.

	==Defining overlays outside of a map==		==Defining overlays outside of a map==

Maikel at 18:38, 12 December 2010

2010-12-12T18:38:10Z

← Older revision		Revision as of 18:38, 12 December 2010
Line 1:		Line 1:
	This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|here]], but only part [[Tutorial:_Map_Generator_-_The_Basics\|one]] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|two]] are prerequisites for this tutorials.		This is the fourth part of the map generator tutorial. The previous part can be found [[Tutorial:_Map_Generator_-_Randomness\|here]], but only part [[Tutorial:_Map_Generator_-_The_Basics\|one]] and [[Tutorial:_Map_Generator_-_Algorithms_%26_Transformations\|two]] are prerequisites for this tutorials. This tutorial discusses some features of the map generator that do not fit into distinct categories.


	==Defining overlays outside of a map==		==Defining overlays outside of a map==

Maikel at 18:05, 12 December 2010

2010-12-12T18:05:31Z

← Older revision		Revision as of 18:05, 12 December 2010
Line 44:		Line 44:

	==Defining multiple maps and loading them==		==Defining multiple maps and loading them==



			==Exercise==


			==Summary==

			By completing this tutorial you know all features of the map generator. The only thing left is to create good looking, dynamic and playable maps. Therefore the last [[Tutorial: Map Generator - Complete Landscapes\|'''part''']] of this tutorial contains some examples about actual playable landscapes.

Maikel: /* Algorithms In C4Script */

2010-12-12T17:35:57Z

Algorithms In C4Script

← Older revision		Revision as of 17:35, 12 December 2010
Line 10:		Line 10:
	A first look at the landscape on the right might make you wonder, how is this created? A quick look into the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html#Algos list] of algorithms will convince you that there is no ellipse neither a circle that can be transformed into an ellipse. The trick here is that you can define your own algorithms in C4Script, by using the <code>script</code> algorithm. Producing decent algorithm might need some mathematical skills as we will see in this example. Leaving the rock border aside for now, we'll focus on the algorithm to create an ellipse first. From the documentation we find that the algorithm must be defined in the scenario script, where the following function is called.		A first look at the landscape on the right might make you wonder, how is this created? A quick look into the [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html#Algos list] of algorithms will convince you that there is no ellipse neither a circle that can be transformed into an ellipse. The trick here is that you can define your own algorithms in C4Script, by using the <code>script</code> algorithm. Producing decent algorithm might need some mathematical skills as we will see in this example. Leaving the rock border aside for now, we'll focus on the algorithm to create an ellipse first. From the documentation we find that the algorithm must be defined in the scenario script, where the following function is called.
	func ScriptAlgo[Overlay-Name](int x, int y, int a, int b)		func ScriptAlgo[Overlay-Name](int x, int y, int a, int b)
	In this function <code>x</code> and <code>y</code> are the pixel coordinates for which the function is called and <code>a, b</code> are the usual parameters. The function should return true if a pixel is to be drawn and false if not. So for our map of <code>MapWidth = MapHeight = 100</code>, <code>x</code> and <code>y</code> range from 0 to 10000. First we scale <code>x</code> and <code>y</code> to normal coordinates and shift them to the middle of the map.Then let <code>a</code> represent the major axis of an ellipse and <code>b</code> the minor axis, see [http://en.wikipedia.org/wiki/Ellipse wikipedia]. Using the canonical form to describe an ellipse we can create the needed ellipse algorithm, it is:		In this function <code>x</code> and <code>y</code> are the pixel coordinates for which the function is called and <code>a, b</code> are the usual parameters. The function should return <code>true</code> if a pixel is to be drawn and <code>false</code> if not. So for our map of <code>MapWidth = MapHeight = 100</code>, <code>x</code> and <code>y</code> range from 0 to 10000. First we scale <code>x</code> and <code>y</code> to normal coordinates and shift them to the middle of the map.Then let <code>a</code> represent the major axis of an ellipse and <code>b</code> the minor axis, see [http://en.wikipedia.org/wiki/Ellipse wikipedia]. Using the canonical form to describe an ellipse we can create the needed ellipse algorithm, it is:
	// ''Constructs an ellipse with major axis a and minor axis b in percent of the overlay.''		// ''Constructs an ellipse with major axis a and minor axis b in percent of the overlay.''
	func ScriptAlgoEllipse(int x, int y, int a, int b)		func ScriptAlgoEllipse(int x, int y, int a, int b)
Line 34:		Line 34:
	algo=script; a=80; b=40;		algo=script; a=80; b=40;
	mat=Gold; tex=gold;		mat=Gold; tex=gold;
	// ''Use border algorithm to create a rock border.''		// ''Use the border algorithm to create a rock border.''
	overlay {		overlay {
	algo=border; a=5; b=5;		algo=border; a=5; b=5;