Qrow: 1 revision imported

2025-11-13T02:14:57Z

1 revision imported

← Older revision	Revision as of 19:14, 12 November 2025
(No difference)

interwiki>Gajop: /* mapinfo.lua */

2018-12-18T15:38:21Z

mapinfo.lua

New page

= Details =
Splat Detail textures extend the default single detail texture that is applied uniformly over the entire map, by allowing the mapper to specify 4 different greyscale detail textures, and offers control of the strength, spatial distribution and tiling resolution of each detail texture.

Important: Splat Detail textures requires a specular texture [[Mapdev:specular]] to exist and be defined in order to be enabled!

{{Caution|requires clients to have GLSL-spec hardware}}
<center>
{| class="wikitable"
|+ Example
| [[File:Mapdev-splat-without.jpg|330px]] || [[File:Mapdev-splat-with.jpg|330px]]
|-
! Default Detail Map !! Splat Detail Maps
|-
| colspan="2" | ''* Click on images for higher res''
|}</center>

= Specification =
== mapinfo.lua ==
<pre>
local mapinfo = {
...
resources = {
...
splatDistrTex = "splatDistributionTex.tga",
splatDetailTex = "splatDetailTex.tga",
...
},
...
splats = {
texScales = {0.02, 0.02, 0.02, 0.02},
texMults = {1.0, 1.0, 1.0, 1.0},
},
...
}</pre>

=== texScales ===

texScales offers a way to adjust the tiling resolution of each of the 4 splat detail textures. Values of 0.02 are the default values, lower values will increase the size of the textures on the ground, and higher values will decrease the tile size.

<center>
{| class="wikitable"
|[[File:Map measure.png|512px|measuring stick]]
|-
! texScales
|}</center>

=== texMults ===

texMults offers a quick way to adjust the strength at which each detail texture will be blended onto the map. Values of 1.0 are the default values, lower values will make the detail texture fainter, higher values make it more pronounced. This is very useful for fine-tuning the strengths after generating the splat distribution texture, which is time-consuming to manipulate in an image editor, and cant be increased above a certain value there.

== Distribution Image ==
{| class="wikitable" width="100%"
! width="15%" | File Location
| ./maps/
|-
! File Format
| PNG, TGA
|-
! Colour Depth
| 8bpp
|-
! Channels
| RGBA
|-
! Resolution
| Any, recommended powers of two, will be stretched over the terrain.
|}

The RGBA Channels are individual greyscale distribution maps which define which detail textures to splat onto the ground. The intensity of the splatted textures is multipled by the pixel values for the corresponding channels.
<center>
{| class="wikitable"
|+ Example
| [[File:Mapdev-ddist.gif]] || [[File:Mapdev-ddist.png]]
|-
! Detail Distribution maps !! Combined Result
|}</center>

== Detail Image ==
{| class="wikitable" width="100%"
! width="15%" | File Location
| ./maps/
|-
! File Format
| PNG, TGA
|-
! Colour Depth
| 8bpp
|-
! Channels
| RGBA
|-
! Resolution
| Any, recommended powers of two, will be tiled over the terrain.
|}
Each Channel represents a seperate greyscale image. The ground colour is multiplied by the pixel values of the channel. The intensity of the effect is also controlled per channel using the {{xtaglink|mapinfo.lua|texMults}} variables, low numbers = less effect.
<center>
{| class="wikitable"
|+ Example
| [[File:Mapdev-details.gif]] || [[File:Mapdev-details.png]]
|-
! Individual Detail Textures !! Combined Result
|}</center>

= Forum Discussion =
* [http://springrts.com/phpbb/viewtopic.php?f=56&t=21565 Detail texture resource thread]
* [http://springrts.com/phpbb/viewtopic.php?f=13&t=22564 Detail texture splatting is ready!]

[[Category:Map Dev]]

Mapdev:splatdetail - Revision history

Qrow: 1 revision imported

interwiki>Gajop: /* mapinfo.lua */