Spring - User contributions [en]

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T20:43:01Z

Tinnut:

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a new png image the same size as your heightmap (although you could make it larger or smaller) and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet. For our example I created this:

[http://img185.imageshack.us/my.php?image=texturedistributionpa8.png http://img185.imageshack.us/img185/2641/texturedistributionpa8.th.png]

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
image_pattern { png "texture_distribution.png" }
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

Here is a screen shot of our map using this:

[http://img341.imageshack.us/my.php?image=screen000wd0.png http://img341.imageshack.us/img341/43/screen000wd0.th.png]

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T20:37:13Z

Tinnut: /* Complex Texture Map Combinations */

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T20:18:30Z

Tinnut:

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a new png image the same size as your heightmap (although you could make it larger or smaller) and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet. For our example I created this:

[http://img185.imageshack.us/my.php?image=texturedistributionpa8.png http://img185.imageshack.us/img185/2641/texturedistributionpa8.th.png]

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
image_pattern { png "texture_distribution.png" }
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T20:03:31Z

Tinnut: /* Complex Texture Map Combinations */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a new png image the same size as your heightmap (although you could make it larger or smaller) and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet.

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
image_pattern { png "texture_distribution.png" }
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T20:01:13Z

Tinnut: Undo revision 14237 by Tinnut (Talk)

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a texture function:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getTextureType = function {
pigment {
image_map {
png "texture_distribution.png"
}
scale <1,-1,1>
}
}
</pre>
|}
2) Create a png image the same size as your heightmap and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet.

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
getTextureType
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T19:52:58Z

Tinnut: /* Complex Texture Map Combinations */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T19:38:46Z

Tinnut: /* Initial Steps */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
#declare primaryHF=
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

// ** If you're going to add the metal placement stuff
// ** described below, you need to put it here!

object {primaryHF}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a texture function:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getTextureType = function {
pigment {
image_map {
png "texture_distribution.png"
}
scale <1,-1,1>
}
}
</pre>
|}
2) Create a png image the same size as your heightmap and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet.

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
getTextureType
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T19:35:45Z

Tinnut: /* Placing Metal Textures */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a texture function:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getTextureType = function {
pigment {
image_map {
png "texture_distribution.png"
}
scale <1,-1,1>
}
}
</pre>
|}
2) Create a png image the same size as your heightmap and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet.

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
getTextureType
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Map development

2008-02-27T09:59:18Z

Tinnut: /* Specific Guides */

=Map making SM3=

SM3 (Spring Mapformat 3) is getting allong nicely and maps using this format can be made. The following is documented so far.

*[[SM3_Map_Format|jcnossen's brief description on how this mapformat works.]]
*[[SM3_FAQ|The first FAQ for the new mapformat.]]

[[Image:sm3-minimap-thumb.jpg]]

=Map making, SMF=
Maps, are a complex mixture of heightmaps and textures.
Fortunately, there are several people who share their knowledge with us.
There few tutorials will make your life as mapper a lot better.

=Skyboxes=
*[[Skyboxcreation|Notes about skyboxes]] notes on a prerendered sky box or cube map.

== Full Guides For Map Making ==

*[[Create_maps|aGorm's map creating Guide]]
*[[Map_Making_Guide|aGorms Ultimate Map Making Guide(unfinished)]]
*[[IceXuick_Map_Design_Help|IceXuicks Map creating Guide]]
*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=3941 Forboding Angel's map creating Tutorial]
*[[Maps:Tutorial|Another tutorial from a designing point of view]]
*[[A_Complete_Map_Making_Tutorial|A Complete Map Making Tutorial (under construction)]]
*[[Runecrafter|Runecrafter's Map Tutorial]]
*[[Zorbawic%27s_Map_Design_Help_in_Polish_language_%28Jak_zrobi%C4%87_mape_do_Springa_-_po_Polsku%29| Zorbawic's Map Design Help in Polish language (Jak zrobiÃ„â€¡ mape do Springa - po Polsku)]]

== Specific Guides ==

*[[Quanto_OTAMAP_Guide|Quanto's Guide to OTA Porting and Small Maps]]
*[[Maps:SMD|Everything about .SMD]]
*[[Maps:Compiling|Everything about Compiling your map]]
*[[MapsBalance|Some things about map balance]]
*[[MapSizes|Map sizes in pixels]] and memory information about map sizes
*[[Height Map Tutorial|RogerN's height map tutorial]]
*[[Create_map_texture_with_povray|Basic howto: create map texture with Povray]]

Features. Stones, rocks, trees, for your map can be found in [http://taspring.clan-sy.com/phpbb/viewtopic.php?t=4047 This thread]<br>

== Tools ==

*[http://taspring.clan-sy.com/phpbb/viewtopic.php?t=2420 Maelstrom's SMD Generator]
*[http://www.fileuniverse.com/?p=show&a=it&id=1507 Mother's Mapconv]
*[http://user.supradigital.org/jcnossen/FeaturePlacer.zip Jnossen's SM3 feature placer]
*[[Maps:Map Designer]] Hugh's 3D map designer. Splatting, heightmap editing, splat painting, SM3
*[http://modinfo.unknown-files.net/coord/mapcoords.php Online starting position creator]
: You can always find out which x/y coordinates are good while starting spring and having a look at the mouse cursor coordinates.

== Mappers Clan ==
[[Map Making Guild]]: That weird fish aGorm set up a clan for poor mappers that can't get into a clan on there gaming merit... (Mainly for himself therefor...)

== Reference and FAQs ==

* [[Maps:Noob Mistakes]]
* [[Water Height: Mapconv vs. Heightmap]]

----
TIPS:

A useful tip, on almost every map in a 1v1 you will start opposite your opponent unless you choose your position. this is because random order simply randomly distributes players at the default start points which in almost every map are opposite each other. One exception that I know of is flooded desert where you both start on the left hand island.
----

''' [[Main_Page|<- Back to Main page]]'''

[[Category:Map development]]

Tutorial:MapWithPOVRay(Tinnut)

2008-02-27T09:53:41Z

Tinnut: /* Howto: Create a map's texture using Povray to generate the texture */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a texture for a Spring map using the freeware Povray program. Povray is an excellent [http://en.wikipedia.org/wiki/Ray_tracing raytracing] application that generates "scene" images using a scene definition language in a text file. We can use it to create a map's texture by creating a heightfield object, putting our "camera" directly over the object, setting the camera to orthographic, and rendering a bitmap at our map's dimension. The steps below will give you an easy enough to follow process to generate a nice map, but if you want to create different maps you'll need to learn Povray's scene definition language. This language is easy enough to follow, but depending on your tastes you could be better off using a tool that specialises in maps and map textures, such as the excellent [http://www.bundysoft.com/L3DT/ L3DT].

The guide does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

Please note that a lot of the maths used in the scene definition file has only been tested on a 16x16 map (8192x8192 pixels).

Warning: The base textures I use in this example are all mostly rubbish that I created in a couple of minutes. I would suggest that you do not use them in your own maps :)

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like [http://www.gimp.org/ The GIMP], which is good, and it's free). Here is the one we'll use for our map (I created this in a hurry and it was quite a mistake that it ended up so similar to Altered Divide):

[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

Your map will need to be named povmap_height.png, but if you want to use another name, just update the pov script below to use your heightmap's actual name.

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

[http://img176.imageshack.us/my.php?image=level1zd7.png http://img176.imageshack.us/img176/953/level1zd7.th.png]

4.2) Middle elevation (main map surface):

[http://img170.imageshack.us/my.php?image=level2pf6.png http://img170.imageshack.us/img170/6473/level2pf6.th.png]

4.3) Highest elevation (mountains):

[http://img176.imageshack.us/my.php?image=level3wv7.png http://img176.imageshack.us/img176/6159/level3wv7.th.png]

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

[http://img411.imageshack.us/my.php?image=slope1on6.png http://img411.imageshack.us/img411/2153/slope1on6.th.png]

5.2) Higher elevations:

[http://img411.imageshack.us/my.php?image=slope2fk7.png http://img411.imageshack.us/img411/8908/slope2fk7.th.png]

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_EL=600; // elevation

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_EL + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next,
// depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next,
// depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures
// and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

// now scale to the maps height x width
scale <MAP_WIDTH, MAP_HEIGHT, MAP_EL>
// and center it for the camera
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_EL/2>
}

</pre>
|}

What we're essentially doing above is:

* Setting up scene parameters: lighting, the orthographic camera, etc.

* Defining a set of textures to display at different elevations and different slopes; and

* Defining a heightmap that uses our png image and applies our texture to this object

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):

9.1) Drop down menu "Render" > "Edit Settings/Render" > Click "Edit" button

9.2) Add text at bottom of file:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
[8192x8192, No AA Spring]
Width=8192
Height=8192
Antialias=Off
</pre>
|}

9.3) Save file

10) Restart Povray so that it re-reads the ini-file

11) Select your new render size and click Render. This creates a bitmap file: gen_pov_texture.bmp

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps). I personally use [http://www.imagemagick.org/ imagemagick] to do this as it has a simple command line program "convert.exe" that will convert an image from one format to another and it works well with the very large bitmap image that comes out of the above steps.

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

Our blend function could actually be an image if you wanted finer control of a map's texture, by having sections of metal mixed with sections of wilderness, for example. To do this, you would:

1) Create a texture function:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare getTextureType = function {
pigment {
image_map {
png "texture_distribution.png"
}
scale <1,-1,1>
}
}
</pre>
|}
2) Create a png image the same size as your heightmap and paint sections of the map that are to use your wilderness textures in white, and the sections that are to use your metal texture in black. For effect you could do a slight blur on the image to create grey coloured transitions where the two sections meet.

3) Change the "final_texture" texture name in your script to "final_nature_texture"

4) Define a set of textures in a similar manner that define your metal textures (based on heights and slopes), with the final blended metal texture named "final_metal_texture". Don't forget to give them different names than the wilderness texture names are.

5) Create a new "final_texture" that is:

{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
#declare final_texture =
texture {
getTextureType
texture_map {
[0.00 final_metal_texture]
[1.00 final_nature_texture]
}
}
</pre>
|}

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures - like "Painted Rock". Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

The povray install also includes a number of nice example procedural textures.

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre>
// A transparent texture
#declare Transparent_Texture=
texture {
pigment {color rgbt<0,0,0,1>}
}

// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the
// Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:90%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_EL*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-26T10:53:55Z

Tinnut: /* Initial Steps */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a Spring map's texture using the freeware Povray program. It does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like The GIMP). Here is the one we'll use for our map:
[http://img441.imageshack.us/my.php?image=povmapheightbp9.png http://img441.imageshack.us/img441/8862/povmapheightbp9.th.png]

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

4.2) Middle elevation (main map surface):

4.3) Highest elevation (mountains):

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

5.2) Higher elevations:

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_ELEVATION=600;

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_ELEVATION + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next, depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next, depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

scale <MAP_WIDTH, MAP_HEIGHT, MAP_ELEVATION> // now scale to the maps height x width
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_ELEVATION/2> // and center it for the camera
}

</pre>
|}

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):
9.1)
9.2)

10) Restart Povray

11) Select your new reder size Click Render

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps)

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-26T09:42:42Z

Tinnut:

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a Spring map's texture using the freeware Povray program. It does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like The GIMP). Here is the one we'll use for our map:

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

4.2) Middle elevation (main map surface):

4.3) Highest elevation (mountains):

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

5.2) Higher elevations:

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>

// Setup some parameters that we will use within the script
#declare MAP_WIDTH=8192;
#declare MAP_HEIGHT=8192;
#declare MAP_ELEVATION=600;

global_settings {
// ambient light level
ambient_light rgb<1,1,1>
}

// Set a directional light
light_source {
<100,-100,100> * 20, color rgb 1
parallel
point_at <1, 0, 0>
}

// Set the background colour
background {rgb<1,1,1>}

// Define our camera position, and set it to "orthographic" (important :)
camera {
orthographic
location <0,0,MAP_ELEVATION + 90> // position & direction of view
look_at <0,0,0>
right MAP_WIDTH*x // horizontal size of view
up MAP_HEIGHT*z // vertical size of view
}

// ** Define our primary textures **

// lowest texture (512 x 512)
// Found in low lying areas of the heightfield
#declare level1_texture =
texture {
pigment {
image_map {
png "level1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// middle texture (512 x 512)
// Found in the middle areas of the heightfield
#declare level2_texture =
texture {
pigment {
image_map {
png "level2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// highest texture (512 x 512)
// Found in the peaks / hills / mountains of the heightfield
#declare level3_texture =
texture {
pigment {
image_map {
png "level3.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one level's texture to the next, depending on elevation:
#declare levels_elevation_texture=
texture {
gradient z

texture_map {
[0.00 level1_texture] // from 0.0 to 0.1 we have just level1.png
[0.10 level1_texture]
// from 0.1 to 0.2 we blend from level1.png to level2.png
[0.30 level2_texture] // from 0.2 to 0.5 we have just level2.png
[0.40 level2_texture]
// from 0.5 to 0.6 we blend from level2.png to level3.png
[0.60 level3_texture] // from 0.6 to 1.0 we have just level2.png
[1.00 level3_texture]
}
}

// ** Define textures used on areas of slope

// lower slope texture (512 x 512)
#declare slope1_texture =
texture {
pigment {
image_map {
png "slope1.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// upper slope texture (512 x 512)
#declare slope2_texture =
texture {
pigment {
image_map {
png "slope2.png"
}
}
finish {ambient 1 diffuse 0}
scale <512/MAP_WIDTH, 512/MAP_WIDTH, 512/MAP_WIDTH>
}

// Define a texture that blends from one slope's texture to the next, depending on elevation:
#declare slopes_elevation_texture=
texture {
gradient z

texture_map {
[0.00 slope1_texture]
[0.30 slope1_texture]

[0.65 slope2_texture]
[1.00 slope2_texture]
}
}

// ** Now define the final texture blending between the height textures and the slope textures:
#declare final_texture =
texture {
slope {
<0,0,-1>, 0, 0.5
}
texture_map {
[0.00 levels_elevation_texture]
[0.06 levels_elevation_texture]
[0.40 slopes_elevation_texture]
[1.00 slopes_elevation_texture]
}
}

// ***!! Now we declare our heightfield object that uses this texture
height_field {
png "povmap_height.png"
smooth // smooth the heightfield
no_shadow // you may want to remove this
translate <-.5, -.5, -.5>
rotate <90,0,0> // rotate it so that the projection of the texture is correct
scale <1,-1,1> // invert the y axis
translate <0.5, 0.5, 0.5>
texture {
final_texture
}

scale <MAP_WIDTH, MAP_HEIGHT, MAP_ELEVATION> // now scale to the maps height x width
translate <-MAP_WIDTH/2, -MAP_HEIGHT/2, -MAP_ELEVATION/2> // and center it for the camera
}

</pre>
|}

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):
9.1)
9.2)

10) Restart Povray

11) Select your new reder size Click Render

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps)

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre><pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>
|}
This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>
|}
3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-26T06:12:59Z

Tinnut:

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a Spring map's texture using the freeware Povray program. It does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like The GIMP). Here is the one we'll use for our map:

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

4.2) Middle elevation (main map surface):

4.3) Highest elevation (mountains):

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

5.2) Higher elevations:

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):
9.1)
9.2)

10) Restart Povray

11) Select your new reder size Click Render

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps)

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>

This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>

3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

Tutorial:MapWithPOVRay(Tinnut)

2008-02-26T06:12:35Z

Tinnut: /* Howto: Create a map's texture using Povray to generate the texture */

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

=== Intro ===
This guide will take you through creating a Spring map's texture using the freeware Povray program. It does not cover other aspects of map creation (heighmaps, features, metal, compiling, etc), but there are a few excellent guides within the Wiki that already cover those steps.

Povray is available for both Windows and Linux. I have only tested these steps under Windows, but they should work under Linux.

=== Initial Steps ===
1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like The GIMP). Here is the one we'll use for our map:

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

4.2) Middle elevation (main map surface):

4.3) Highest elevation (mountains):

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

5.2) Higher elevations:

6) Create an empty text file in your C:\Povmap folder named gen_pov_texture.pov

7) Copy the following povray scene code into the above file:

8) Double click on your gen_pov_texture.pov file so that it opens up in Povray.

9) Add a new render size (8192 x 8192):
9.1)
9.2)

10) Restart Povray

11) Select your new reder size Click Render

12) Convert to gen_pov_texture.bmp to a png file if you're using the new mapconv (it doesn't seem to like bitmaps)

13) Do all the other map stuff: metal placement bitmap, feature placement bitmap, smd file

14) Compile your map with mapconv

15) Test it :)

== Advanced stuff ==
Check out your help file that came with Povray. There is a LOT that you can do!

=== Complex Texture Map Combinations ===
As you can see from the pov code above, a "texture" declaration can be an image (called an "image_map"), but it can also be a definition of a blend between any number of earlier defined textures (called a "texture_map"), which is based on a function. In the above example, it uses the "gradient" function for changes in elevation, and the "slope" function for changes in slope. It is possible to define much more complex sets of textures than those defined above, such as mixing different combination of slope mapings with combinations of elevation mapings.

=== Procedural Textures ===
It is also possible to use "procedural textures" instead of image_map textures. These can be quite useful for areas on your map that have a high slope as they can create a better looking texture, including effects such as the layered rock textures. Unfortunately these types of textures can result in larger map sizes, but if you just use them on the high slope areas of your map it should not be too bad.

Some good examples used in terrains can be found at the [http://geomorph.sourceforge.net/povray/en/Geomorph%20-%20Predefined%20Povray%20Scripts.html Geomorph website].

=== Placing Metal Textures ===
There are quite a few posible ways to have Povray place metal textures for you. One approach that I have used is:

1) Define a function that will return the current metal locations in a pov kind of way:
<pre>
#declare getMetal = function {
pigment {
image_map {
png "metallocations.png"
}
scale <1,-1,1>
}
}
</pre>

This function, when called for a given coordinate (0 to 1), returns a vector of the three colours for that point.

2) We now define a texture that we'll use for our metal (this is made up of a number of subcomponent textures):
<pre>
// A simple brownish texture
#declare dirt_Texture=
texture {
pigment { rgb <0.75,0.55,0.35>*0.7 }
normal {
granite 0.5 // for use with normal{} (0...1 or more)
//scale MAP_WIDTH
}
finish {
ambient 0.5
diffuse .9
}
}

// A shiny metalish texture
#declare metal_TextureBase =
texture {
pigment {
rgb<1,1,1>
}
normal {
granite 0.9 // for use with normal{} (0...1 or more)
scale 80/5
}
finish {
ambient 0.6
brilliance 4
diffuse 1
specular 0.90
roughness 1/80
}
}

// A combination of the metal_TextureBase, the dirt_Texture and the Transparent_Texture
#declare metal_Texture=
texture {
bozo // very smooth, random noise function
turbulence 0.3 // turbulence often useful

texture_map {
[0.0 metal_TextureBase] //T_Silver_3B
[0.42 metal_TextureBase]
[0.47 dirt_Texture]
[0.50 dirt_Texture]
[0.55 Transparent_Texture]
[1.0 Transparent_Texture]
}
//scale <16, 16, 16> //even
scale <7, 32, 16> //stretched
rotate z*40 //set it at an angle so it looks betterer ;)
}

#declare blob_Texture=
texture {
slope { z, 0.0, 0.5 }
texture_map {
[0.0 Transparent_Texture]
[0.6 Transparent_Texture]
[1.0 metal_Texture]
}
}
</pre>

3) Finally, we define a "blob" object that adds a sphere object to the master blob object for each point in the metal map:
{| class="wikitable" style="font-style:italic; font-size:120%; border:1px dashed red;background-color:white"
|
<pre> #declare metalBlob=
blob {
#declare geos=0;
#declare ix=4.0;
#declare num=0;
#while (ix < MAP_WIDTH)
#declare iy=0.0;
#while (iy < MAP_WIDTH)
#declare metal=getMetal(ix/MAP_WIDTH, iy/MAP_WIDTH, 0);
#if (metal.red)
#declare Pos = trace(primaryHF,<ix-MAP_WIDTH/2, -iy+MAP_WIDTH/2, MAP_ELEVATION*2>,-z);
sphere {
//Pos-<0,0,5>, 8*6, 8
Pos-<0,0,5>, 8*2, 8
}
#end
#declare iy=iy+8;
#end
#declare ix=ix+8;
#end

texture {
blob_Texture
}
scale <1,1,0.5>
} //metalBlob

object {metalBlob}</pre>
|}
This all adds some time to the rendering time, but seems to work well enough (although it could be nicer).

{| class="wikitable" style="font-style:italic; font-size:120%; border:3px dashed red;background-color:white"
|+Multiplication table
|-
! × !! 1 !! 2 !! 3
|-
! 1
| 1 || 2 || 3
|-
! 2
| 2 || 4 || 6
|-
! 3
| 3 || 6 || 9
|-
! 4
| 4 || 8 || 12
|-
! 5
| 5 || 10 || 15
|}

http://meta.wikimedia.org/wiki/Help:Table

Tutorial:MapWithPOVRay(Tinnut)

2008-02-25T10:04:29Z

Tinnut: New page: == Howto: Create a map's texture using Povray to generate the texture == !! This is currently a work in progress and make take some time to complete. !! Povray is available for both Wi...

== Howto: Create a map's texture using Povray to generate the texture ==

!! This is currently a work in progress and make take some time to complete. !!

Povray is available for both Windows and Linux so in theory these steps should work for both systems.

1) Download and install Povray: [http://www.povray.org/ Povray Site]

2) Create a working folder for your map, for this example, we'll make C:\PovMap

3) Create a heightmap using whatever program (I like The GIMP). Here is the one we'll use for our map:

4) For our example, we'll be defining three different elevation levels for which there are different terrain textures, these will be (each at 512x512):

4.1) Lowest elevation (low lying areas):

4.2) Middle elevation (main map surface):

4.3) Highest elevation (mountains):

5) Now also for our example, we'll be defining two different textures to be used by sloping areas, one for slopes in the lower elevation areas of the map, and another for slopes in the higher elevations:

5.1) Lower elevations:

5.2) Higher elevations:

6)