Tutorial: Map Generator - The Basics - Revision history

Andriel at 11:58, 13 August 2013

2013-08-13T11:58:02Z

← Older revision		Revision as of 11:58, 13 August 2013
Line 7:		Line 7:
	==Introduction & Features==		==Introduction & Features==

	The landscape generator allows one to create dynamic and interesting landscapes. Dynamic in this context means that every time you start a scenario the landscape will look different. This is a great benefit opposed to static maps, depending of the type of scenario a dynamic map my be a must. On the other hand it is harder to create landscapes that look exactly the way you want it. The map generator can't simply be told to put in five nice looking chunks ~~of gold~~ of some size into the ground.		The landscape generator allows one to create dynamic and interesting landscapes. Dynamic in this context means that every time you start a scenario the landscape will look different. This is a great benefit opposed to static maps, depending of the type of scenario a dynamic map may be a must. On the other hand it is harder to create landscapes that look exactly the way you want it. The map generator can't simply be told to put in five nice looking gold chunks of some size into the ground.

	Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many sub layers inside a layer, which again can have sub layers and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.		Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many sub layers inside a layer, which again can have sub layers and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.
Line 13:		Line 13:
	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own ~~documentation, which can be found~~ [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html ~~here~~]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials. Furthermore we want to write readable generator code, so that we ourselves but most importantly others can profit from it. For this reason [[Map_Generator_Style_Guidelines\|'''style guidelines''']] for map generator code have been compiled which should be followed within the OpenClonk project.		The map generator also has its own [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html documentation]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials. Furthermore we want to write readable generator code, so that we ourselves but most importantly others can profit from it. For this reason [[Map_Generator_Style_Guidelines\|'''style guidelines''']] for map generator code have been compiled which should be followed within the OpenClonk project.

	==Your First Landscape==		==Your First Landscape==
Line 23:		Line 23:
	mat=Water; tex=water;		mat=Water; tex=water;
	};		};
	As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. ~~Now the~~ actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.		As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. The actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.

	In this example we define the material (keyword <code>mat</code>) and the texture (keyword <code>tex</code>) of the map. This map will simply be completely filled with ''Water'' and that water will have the texture ''water''. Valid materials and textures can be found in the TexMap.txt file in the Material.c4g folder, which is explained in the [http://docs.openclonk.org/en/sdk/material/index.html material documentation].		In this example we define the material (keyword <code>mat</code>) and the texture (keyword <code>tex</code>) of the map. This map will simply be completely filled with ''Water'' and that water will have the texture ''water''. Valid materials and textures can be found in the TexMap.txt file in the Material.c4g folder, which is explained in the [http://docs.openclonk.org/en/sdk/material/index.html material documentation].
Line 30:		Line 30:

	[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]		[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]
	That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So ~~Let~~'s add a new layer, new layers can be created with <code>overlay</code>.		That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So let's add a new layer, new layers can be created with <code>overlay</code>.
	// ''Introduced a golden layer.''		// ''Introduced a golden layer.''
	map ExampleLayers {		map ExampleLayers {

Maikel at 12:36, 22 January 2011

2011-01-22T12:36:47Z

← Older revision		Revision as of 12:36, 22 January 2011
Line 29:		Line 29:
	==Layers==		==Layers==

			[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]
	That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So Let's add a new layer, new layers can be created with <code>overlay</code>.		That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So Let's add a new layer, new layers can be created with <code>overlay</code>.
	// ''Introduced a golden layer.''		// ''Introduced a golden layer.''
Line 38:		Line 39:
	};		};
	};		};
	~~[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]~~
	We added a sublayer to the map layer and that sublayer will be filled with the material ''Gold''. Furthermore we told the layer to be limited to the area that starts at <code>x, y</code> (in percent of the upper layer, the map) and to a height and width of 80% of the upper layer (the map).		We added a sublayer to the map layer and that sublayer will be filled with the material ''Gold''. Furthermore we told the layer to be limited to the area that starts at <code>x, y</code> (in percent of the upper layer, the map) and to a height and width of 80% of the upper layer (the map).

Line 45:		Line 45:
	==Combining Layers==		==Combining Layers==

			[[File:MapGenerator_ExampleCombinedLayers.png\|200px\|thumb\|right\|Combined rock and gold layers.]]
	You can combine layers in multiple ways. Low and behold:		You can combine layers in multiple ways. Low and behold:
	// ''Gold, rock and set theory.''		// ''Gold, rock and set theory.''
Line 60:		Line 61:
	};		};
	};		};
	~~[[File:MapGenerator_ExampleCombinedLayers.png\|200px\|thumb\|right\|Combined rock and gold layers.]]~~
	Here begins the fun. The first layer (the gold layer) has got two sublayers which were combined by a logical operator - the ^. Since both layers are inside that gold-layer they will not affect anything outside of that layer. Any coordinates or percentage values are relative to that outer layer.		Here begins the fun. The first layer (the gold layer) has got two sublayers which were combined by a logical operator - the ^. Since both layers are inside that gold-layer they will not affect anything outside of that layer. Any coordinates or percentage values are relative to that outer layer.

Maikel: /* Your First Landscape */

2011-01-22T12:36:15Z

Your First Landscape

← Older revision		Revision as of 12:36, 22 January 2011
Line 17:		Line 17:
	==Your First Landscape==		==Your First Landscape==

			[[File:MapGenerator_ExampleFirstLandscape.png\|200px\|thumb\|right\|One big lake!]]
	The map generator works with nesting, similar to HTML, XML and others. Therefore we start by creating the outer element, the <code>map</code>. This basically is a layer that spans the whole landscape of a scenario. So without further ado, here is your first example landscape.		The map generator works with nesting, similar to HTML, XML and others. Therefore we start by creating the outer element, the <code>map</code>. This basically is a layer that spans the whole landscape of a scenario. So without further ado, here is your first example landscape.
	// ''My first dynamic landscape!''		// ''My first dynamic landscape!''
Line 22:		Line 23:
	mat=Water; tex=water;		mat=Water; tex=water;
	};		};
	~~[[File:MapGenerator_ExampleFirstLandscape.png\|200px\|thumb\|right\|One big lake!]]~~
	As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. Now the actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.		As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. Now the actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.

Maikel at 22:50, 21 January 2011

2011-01-21T22:50:54Z

← Older revision		Revision as of 22:50, 21 January 2011
Line 18:		Line 18:

	The map generator works with nesting, similar to HTML, XML and others. Therefore we start by creating the outer element, the <code>map</code>. This basically is a layer that spans the whole landscape of a scenario. So without further ado, here is your first example landscape.		The map generator works with nesting, similar to HTML, XML and others. Therefore we start by creating the outer element, the <code>map</code>. This basically is a layer that spans the whole landscape of a scenario. So without further ado, here is your first example landscape.

	// ''My first dynamic landscape!''		// ''My first dynamic landscape!''
	map ExampleFirstLandscape {		map ExampleFirstLandscape {
	mat=Water; tex=water;		mat=Water; tex=water;
	};		};

	[[File:MapGenerator_ExampleFirstLandscape.png\|200px\|thumb\|right\|One big lake!]]		[[File:MapGenerator_ExampleFirstLandscape.png\|200px\|thumb\|right\|One big lake!]]
	As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. Now the actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.		As you might have noticed this simply fills the whole map with water, but how does it work. The first line is a comment, everything after a // will be ignored until a new line occurs. Also multi line comments are possible, anything after a /* will be ignored completely until a */ is found. The third line has the keyword <code>map</code>. ''Example1'' is the name of that map. Now the actual definition is inside the brackets { }. To close the definition you also need to put a semicolon behind the closing bracket.
Line 32:		Line 30:

	That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So Let's add a new layer, new layers can be created with <code>overlay</code>.		That first map is somewhat limited. Maybe you could do a submarine battle in it, but that's about it. So Let's add a new layer, new layers can be created with <code>overlay</code>.

	// ''Introduced a golden layer.''		// ''Introduced a golden layer.''
	map ExampleLayers {		map ExampleLayers {
Line 41:		Line 38:
	};		};
	};		};

	[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]		[[File:MapGenerator_ExampleOneLayer.png\|200px\|thumb\|right\|A golden layer submerged in water.]]
	We added a sublayer to the map layer and that sublayer will be filled with the material ''Gold''. Furthermore we told the layer to be limited to the area that starts at <code>x, y</code> (in percent of the upper layer, the map) and to a height and width of 80% of the upper layer (the map).		We added a sublayer to the map layer and that sublayer will be filled with the material ''Gold''. Furthermore we told the layer to be limited to the area that starts at <code>x, y</code> (in percent of the upper layer, the map) and to a height and width of 80% of the upper layer (the map).
Line 50:		Line 46:

	You can combine layers in multiple ways. Low and behold:		You can combine layers in multiple ways. Low and behold:

	// ''Gold, rock and set theory.''		// ''Gold, rock and set theory.''
	map ExampleCombinedLayers {		map ExampleCombinedLayers {
Line 65:		Line 60:
	};		};
	};		};

	[[File:MapGenerator_ExampleCombinedLayers.png\|200px\|thumb\|right\|Combined rock and gold layers.]]		[[File:MapGenerator_ExampleCombinedLayers.png\|200px\|thumb\|right\|Combined rock and gold layers.]]
	Here begins the fun. The first layer (the gold layer) has got two sublayers which were combined by a logical operator - the ^. Since both layers are inside that gold-layer they will not affect anything outside of that layer. Any coordinates or percentage values are relative to that outer layer.		Here begins the fun. The first layer (the gold layer) has got two sublayers which were combined by a logical operator - the ^. Since both layers are inside that gold-layer they will not affect anything outside of that layer. Any coordinates or percentage values are relative to that outer layer.

Maikel at 22:23, 20 January 2011

2011-01-20T22:23:00Z

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

	The next part of this tutorial about algorithms and transformations is [[Tutorial: Map Generator - Algorithms & Transformations\|'''here''']].		The next part of this tutorial about algorithms and transformations is [[Tutorial: Map Generator - Algorithms & Transformations\|'''here''']].

			[[Category:Map Generator Tutorials]]

Maikel: /* Introduction & Features */

2011-01-20T20:59:16Z

Introduction & Features

← Older revision		Revision as of 20:59, 20 January 2011
Line 13:		Line 13:
	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials. Furthermore we want to write readable generator code, so that we ourselves but most importantly others can profit from it. For this reason [[Map_Generator_Style_Guidelines\|'''style guidelines''']]. for map generator code ~~has~~ been compiled which should be followed within the OpenClonk project.		The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials. Furthermore we want to write readable generator code, so that we ourselves but most importantly others can profit from it. For this reason [[Map_Generator_Style_Guidelines\|'''style guidelines''']] for map generator code have been compiled which should be followed within the OpenClonk project.

	==Your First Landscape==		==Your First Landscape==

Maikel at 20:58, 20 January 2011

2011-01-20T20:58:48Z

← Older revision		Revision as of 20:58, 20 January 2011
Line 13:		Line 13:
	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.		The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials. Furthermore we want to write readable generator code, so that we ourselves but most importantly others can profit from it. For this reason [[Map_Generator_Style_Guidelines\|'''style guidelines''']]. for map generator code has been compiled which should be followed within the OpenClonk project.

	==Your First Landscape==		==Your First Landscape==

Maikel: /* Introduction & Features */

2011-01-20T19:17:01Z

Introduction & Features

← Older revision		Revision as of 19:17, 20 January 2011
Line 11:		Line 11:
	Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many sub layers inside a layer, which again can have sub layers and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.		Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many sub layers inside a layer, which again can have sub layers and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.

	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.		The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.

Maikel: /* Introduction & Features */

2011-01-20T19:16:45Z

Introduction & Features

← Older revision		Revision as of 19:16, 20 January 2011
Line 9:		Line 9:
	The landscape generator allows one to create dynamic and interesting landscapes. Dynamic in this context means that every time you start a scenario the landscape will look different. This is a great benefit opposed to static maps, depending of the type of scenario a dynamic map my be a must. On the other hand it is harder to create landscapes that look exactly the way you want it. The map generator can't simply be told to put in five nice looking chunks of gold of some size into the ground.		The landscape generator allows one to create dynamic and interesting landscapes. Dynamic in this context means that every time you start a scenario the landscape will look different. This is a great benefit opposed to static maps, depending of the type of scenario a dynamic map my be a must. On the other hand it is harder to create landscapes that look exactly the way you want it. The map generator can't simply be told to put in five nice looking chunks of gold of some size into the ground.

	Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many ~~sublayers~~ inside a layer, which again can have ~~sublayers~~ and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.		Instead you have bit-layers which get a two dimensional 1-bit-texture. Then a material-texture-combination is assigned to that layer. Also you can create many sub layers inside a layer, which again can have sub layers and a material-texture-combination. Maybe it's easier to imagine as cutting several designs into pieces of paper and putting them behind each other, you'll get blank spots (where all papers have a hole), which will be like "Sky". Maybe you set the first layer to be some kind of an "Earth", that layer then has some shreds of paper on it that represent "Gold". But once you get to some really complicated combinations you'll see that that comparison is somewhat non-representative of the map-generator.

	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. The examples contain a snippet from Landscape.txt file together with some explanation and the generated map displayed on the right But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.		The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.

Maikel: /* Introduction & Features */

2011-01-20T17:15:42Z

Introduction & Features

← Older revision		Revision as of 17:15, 20 January 2011
Line 13:		Line 13:
	The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.		The approach taken in this tutorial is "learning by doing", as it should be the most fun and allows for a smooth introduction into the generator. Though this tutorial can't be completed by just anyone, basic knowledge of scenario creation is understood. The tutorial is divided up in parts, each part covers some theory explained in examples and ends with an exercise. But before starting of with the theory and some example landscapes we need a scenario to view our dynamic landscapes. You can create a scenario or download the scenario containing the first example here[TODO: file]. The map generator reads out the Landscape.txt file inside the scenario folder and generates the landscape at the start of the round. Either create a new Landscape.txt file or open the existing one in the downloaded example scenario. You can only view one example at a time, to view a new one clean the file and copy & paste the new example into your Landscape.txt file. Landscapes are best viewed in editor mode as you can scroll through the landscape.

	The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use in this sequence of tutorials.		The map generator also has its own documentation, which can be found [http://docs.openclonk.org/en/sdk/scenario/MapCreatorS2.html here]. Here all features of the generator can be found, and of course we will use it frequently in this sequence of tutorials.

	==Your First Landscape==		==Your First Landscape==