View source for Mapdev:grass

= Grass =
Grass is entirely optional, but can be customized via map parameters and adds a nice touch to your map.
{| class="wikitable" style="text-align: center;" width="100%"
| [[File:Mapdev-grass.png]] || [[File:Mapdev-grass-example.png|451px]]
|-
! Example Grass Disribution
! In Game Result
|}

= Specification =
== mapinfo.lua ==
<pre>local mapinfo = {
   ...
   smf = {
        ....
        grassmapTex = "",
        ....
   },
   ...
   resources = {
      ...
      grassBladeTex = "",
      grassShadingTex = "",
      ...
   },
   ...
   grass = {
      bladeWaveScale = 1.0,
      bladeWidth = 0.32,
      bladeHeight = 4.0,
      bladeAngle = 1.57,
      bladeColor = {0.59, 0.81, 0.57},
   },
   ...
}</pre>
=== Blade Wave Scale ===
Defaults to 1. It specifies how much the blades will wave in the wind. Higher makes them wave more.

=== Blade Height ===
Default is 4. Defines the length of the blade of grass in elmos.

=== Blade Angle ===
Default is pi/4. It defines how much each blade of grass curves.

=== Blade Color ===
does nothing when blade texture is set.

== Distribution Image ==
Formerly [[Mapdev:features|Feature]] Map. Grass distribution is defined by blue pixels, the more blue the pixel is (the closer to blue 255 it is), the thicker grass will be at that location. 
{| class="wikitable" width="100%"
! width="15%" | File Location
| The distribution map is an intermediary file compiled into the SMF/SMT files using [[MapConv]] or [[MapConvNG]], it can also be specified in the mapinfo.lua
|-
! File Format
| Any that Mapconv programs support
|-
! Colour Depth
| 8bpp
|-
! Channels
| Greyscale
|-
! Resolution
| <center>
{| class="wikitable" style="text-align: center;"
!Spring Map Size<sup>*</sup>
!pixels = Spring Map Size * 16
|-
| 2
| 32
|-
| 4
| 64
|-
| 6
| 96
|-
| ...
| ...
|-
| 32
| 512
|-
| style="text-align: left;font-style:italic" colspan=2 | &#42; must be multiples of 2
|}</center>
|}

== Shading Image ==
* If a shading image is not present, the minimap will be used in its place.
{| class="wikitable" width="100%"
! width="15%" | File Location
| ./maps/
|-
! File Format
| PNG, TGA
|-
! Colour Depth
| 8bpp
|-
! Channels
| RGB
|-
! Resolution
| Any, recommended powers of two, will be stretched over the terrain.
|}
<center>
{| class="wikitable"
| [[File:Grassmap_Map_example.jpegâ€Ž]] || [[File:Grassmap_Map_ingame.jpg|512px|â€Ž]]
|-
! Example !! Result
|}</center>

== Blade Texture ==
Specify a texture for the individual grass blades. The grass blades go from top to bottom, vertically. 
{| class="wikitable" width="100%"
! width="15%" | File Location
| ./maps/
|-
! File Format
| PNG, TGA
|-
! Colour Depth
| 8bpp
|-
! Channels
| RGB (alpha does nothing here)
|-
! Resolution
| Any
|}

<center>
{| class="wikitable" style="text-align: center;"
| https://springrts.com/mediawiki/images/3/36/Grass_blade_tex_testing.png || https://springrts.com/mediawiki/images/9/9f/Grass_blade_tex_ingame.PNG
|-
! Example  !! Result
|}</center>

= Forum Discussions =
* [http://springrts.com/phpbb/viewtopic.php?f=13&t=27585 Try to keep perspective]

[[Category:Map Dev]]