MultiHexTutorial - Revision history

Egallager: lede

2023-05-08T03:41:55Z

lede

Celtic Minstrel: /* First example: mountains */ Syntax highlighting

2021-04-18T04:36:46Z

‎First example: mountains: Syntax highlighting

Max2008 at 08:22, 8 April 2014

2014-04-08T08:22:17Z

Esr: Remove Obsolete tag and a bad link.

2008-03-01T08:53:28Z

Remove Obsolete tag and a bad link.

SkeletonCrew: updated examples

2008-03-01T08:34:37Z

updated examples

Esr: Categorize

2008-02-29T22:15:24Z

Categorize

Sgt. Groovy at 19:37, 21 February 2008

2008-02-21T19:37:18Z

WikiSysop at 14:54, 9 July 2005

2005-07-09T14:54:39Z

New page

(quickly written, I'll explain it more in detail when I have more time -- Ayin)

== First example: mountains ==

Suppose we have the following map to fill with mountain tiles:

http://www.anathas.org/ayin/wesnoth/tutorial/tutorial1.png

And we have the following images to fill it:

* tile1: http://www.anathas.org/ayin/wesnoth/tutorial/tile1.png
* tile2: http://www.anathas.org/ayin/wesnoth/tutorial/tile2.png
* tile5: http://www.anathas.org/ayin/wesnoth/tutorial/tile5.png

We will use the following three rules to fill the mountains. Beware: '''Spaces into maps do matter!'''

[terrain_graphics]
map="
. 1
.
. 1
.
. 1
1
1"
[tile]
pos=1
type=m
[/tile]

probability=30
no_flag="base"
set_flag="base"

[image]
layer=-1000
name=tile5
[/image]
[/terrain_graphics]

[terrain_graphics]
map="
.
1
1"
[tile]
pos=1
type=m
[/tile]

probability=30
no_flag="base"
set_flag="base"
[image]
layer=-1000
name=tile2
[/image]
[/terrain_graphics]

[terrain_graphics]
[tile]
x=0
y=0
type=m
[/tile]
probability=100
no_flag="base"
set_flag="base"
[image]
layer=-1000
name=tile1
[/image]
[/terrain_graphics]

The first rule, regarding the biggest mountains, will apply first. It will include, with 30% probability, the big
5-tile mountain range. This will make, for example, something like this.

http://www.anathas.org/ayin/wesnoth/tutorial/tutorial2.png

The second rule will then apply. Note that the previous rule had set the "built-m" flag, thus preventing the mountains
from the second rule to overlap the place where the first mountains already have been placed. The result will be
something like that:

http://www.anathas.org/ayin/wesnoth/tutorial/tutorial3.png

The, the last rule, with 100% probability (the probability key could have been omitted) will apply. It will place a
mountain tile on the places where no other mountain tile was placed. The final mountain range will look like that:

http://www.anathas.org/ayin/wesnoth/tutorial/tutorial4.png

== Village with a tower ==

To add a building with a tower that spans over 2 hexes, you may use the following rule (T being the character
representing the building hex)

[terrain_graphics]
map="
**

T"
[image]
name=tower # a 36x72 image
position=vertical
base=36,108
[/image]

[/terrain_graphics]

== Reference ==

Map:

'.' means "this rule does not apply to this hex" (i.e: no image will be set to this hex, this hex will not be checked
for flags, etc).

'*' means "this rule applies to this hex, but this hex can be any terrain type".

Flags:

no_flag="built-m" means that the rule only matches if the flag "built-m" is not set.

set_flag="built-m" means that the rule, upon matching, sets the flag "built-m".

== See Also ==

* [[BuildingRuleWML]]

← Older revision		Revision as of 03:41, 8 May 2023
Line 1:		Line 1:
		+	This is a tutorial having to do with the [[TerrainGraphicsWML\|Terrain Graphics]] system.
		+
	(quickly written, I'll explain it more in detail when I have more time -- Ayin)		(quickly written, I'll explain it more in detail when I have more time -- Ayin)

← Older revision		Revision as of 08:53, 1 March 2008
Line 123:		Line 123:
	set_flag="built-m" means that the rule, upon matching, sets the flag "built-m".		set_flag="built-m" means that the rule, upon matching, sets the flag "built-m".

−	~~== See Also ==~~
−
−	* [[BuildingRuleWML]]

	[[Category:Art Tutorials]]		[[Category:Art Tutorials]]
−	~~[[Category:Obsolete]]~~

← Older revision		Revision as of 22:15, 29 February 2008
Line 126:		Line 126:
	* [[BuildingRuleWML]]		* [[BuildingRuleWML]]

−	[[Category: Art Tutorials]]	+	[[Category:Art Tutorials]]
		+	[[Category:Obsolete]]

← Older revision		Revision as of 19:37, 21 February 2008
Line 126:		Line 126:
	* [[BuildingRuleWML]]		* [[BuildingRuleWML]]

		+	[[Category: Art Tutorials]]

@@ Line 15: / Line 15: @@
 We will use the following three rules to fill the mountains. Beware: '''Spaces into maps do matter!'''
- [terrain_graphics]
+<syntaxhighlight lang=wml>
-         map="
+[terrain_graphics]
-  .,   1
+        map="
- ,  .
+.  ,  1
-  .,   1
+,  .
- ,  .
+.  ,  1
-  .,   1
+,  .
- ,  1
+.  ,  1
-"
+,  1
-         [tile]
+"
-                 pos=1
+        [tile]
-                 type=Mm
+                pos=1
-         [/tile]
+                type=Mm
-         probability=30
+[terrain_graphics]
-         no_flag="base"
+        map="
-         set_flag="base"
-         [image]
+[terrain_graphics]
-                 layer=-1000
+        [tile]
-                 name=tile5
+                x=0
-         [/image]
+                y=0
- [/terrain_graphics]
+                type=Mm
+        [/tile]
- [terrain_graphics]
+        probability=100
-         map="
+        no_flag="base"
+        set_flag="base"
- ,  1
+        [image]
-"
+                layer=-1000
-         [tile]
+                name=tile1
-                 pos=1
+        [/image]
-                 type=Mm
+[/terrain_graphics]
-         [/tile]
+</syntaxhighlight>
 The first rule, regarding the biggest mountains, will apply first. It will include, with 30% probability, the big

@@ Line 5: / Line 5: @@
 Suppose we have the following map to fill with mountain tiles:
-http://www.anathas.org/ayin/wesnoth/tutorial/tutorial1.png
+http://wesnoth.org/wiki-images/multi-hex/tutorial1.png
 And we have the following images to fill it:
-* tile1: http://www.anathas.org/ayin/wesnoth/tutorial/tile1.png
+* tile1: http://wesnoth.org/wiki-images/multi-hex/tile1.png
-* tile2: http://www.anathas.org/ayin/wesnoth/tutorial/tile2.png
+* tile2: http://wesnoth.org/wiki-images/multi-hex/tile2.png
-* tile5: http://www.anathas.org/ayin/wesnoth/tutorial/tile5.png
+* tile5: http://wesnoth.org/wiki-images/multi-hex/tile5.png
 We will use the following three rules to fill the mountains. Beware: '''Spaces into maps do matter!'''
@@ Line 76: / Line 76: @@
 -tile mountain range. This will make, for example, something like this.
-http://www.anathas.org/ayin/wesnoth/tutorial/tutorial2.png
+http://wesnoth.org/wiki-images/multi-hex/tutorial2.png
 The second rule will then apply. Note that the previous rule had set the "built-m" flag, thus preventing the mountains
@@ Line 82: / Line 82: @@
 something like that:
-http://www.anathas.org/ayin/wesnoth/tutorial/tutorial3.png
+http://wesnoth.org/wiki-images/multi-hex/tutorial3.png
 The, the last rule, with 100% probability (the probability key could have been omitted) will apply. It will place a
 mountain tile on the places where no other mountain tile was placed. The final mountain range will look like that:
-http://www.anathas.org/ayin/wesnoth/tutorial/tutorial4.png
+http://wesnoth.org/wiki-images/multi-hex/tutorial4.png
 == Village with a tower ==

@@ Line 17: / Line 17: @@
   [terrain_graphics]
           map="
-  .   1
+  .,   1
+ ,  .
-  .   1
+  .,   1
+ ,  .
-  .   1
+  .,   1
+ ,  1
 "
           [tile]
                   pos=1
-                  type=m
+                  type=Mm
           [/tile]
@@ Line 42: / Line 42: @@
           map="
+  .
+ ,  1
 "
           [tile]
                   pos=1
-                  type=m
+                  type=Mm
           [/tile]
@@ Line 62: / Line 62: @@
                   x=0
                   y=0
-                  type=m
+                  type=Mm
           [/tile]
           probability=100
@@ Line 91: / Line 91: @@
 == Village with a tower ==
-To add a building with a tower that spans over 2 hexes, you may use the following rule (T being the character
+To add a building with a tower that spans over 2 hexes, you may use the following rule (Tt being the character
 representing the building hex)
   [terrain_graphics]
-       map="
+       map="*, 1"
-**
+      [tile]
+          pos=1
- T"
+          type=Tt
        [image]
            name=tower # a 36x72 image