Mapdev:water - Revision history

Gajop at 16:35, 13 May 2020

2020-05-13T16:35:34Z

← Older revision		Revision as of 17:35, 13 May 2020
Line 7:		Line 7:

	Water has five different rendering modes which can be set ingame by the command:		Water has five different rendering modes which can be set ingame by the command:
	~~<code>~~<pre>/water</pre~~></code~~>		<pre>/water</pre>
	<ol start=0>		<ol start=0>
	<li> basic		<li> basic
Line 25:		Line 25:

	== Options that are always relevant ==		== Options that are always relevant ==
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	tidalStrength = 0,		tidalStrength = 0,
Line 42:		Line 42:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{tag\|name=tidalStrength\|type=float}}		{{tag\|name=tidalStrength\|type=float}}
Line 68:		Line 68:
	\| [[File:Water basic example.jpg\|400px]]		\| [[File:Water basic example.jpg\|400px]]
	\|}</center>		\|}</center>
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	water = {		water = {
Line 77:		Line 77:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{tag\|name=repeatX\|type=float\|default=0\|description=control the texture repetition}}		{{tag\|name=repeatX\|type=float\|default=0\|description=control the texture repetition}}
Line 91:		Line 91:
	\| {{FIXME}}need to place an image here		\| {{FIXME}}need to place an image here
	\|}</center>		\|}</center>
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	water = {		water = {
Line 97:		Line 97:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{FIXME}}?		{{FIXME}}?
Line 109:		Line 109:
	\| [[file:water_dynamic_example.jpg\|400px]]		\| [[file:water_dynamic_example.jpg\|400px]]
	\|}</center>		\|}</center>
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	water = {		water = {
Line 116:		Line 116:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{tag\|name=surfaceColor\|type=float3f\|default={0.0, 0.0, 0.0}\|description=Effects the reflected colour.}}		{{tag\|name=surfaceColor\|type=float3f\|default={0.0, 0.0, 0.0}\|description=Effects the reflected colour.}}
Line 129:		Line 129:
	\| [[file:water_refractive_example.jpg\|400px]]		\| [[file:water_refractive_example.jpg\|400px]]
	\|}</center>		\|}</center>
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	water = {		water = {
Line 135:		Line 135:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{tag\|name=surfaceColor\|type=float3f\|default={0.0, 0.0, 0.0}\|description=Effects the reflected colour.}}		{{tag\|name=surfaceColor\|type=float3f\|default={0.0, 0.0, 0.0}\|description=Effects the reflected colour.}}
Line 145:		Line 145:
	\| {{FIXME}}need to place an image here		\| {{FIXME}}need to place an image here
	\|}</center>		\|}</center>
	~~<code>~~<pre>local mapinfo = {		<pre>local mapinfo = {
	...		...
	water = {		water = {
Line 187:		Line 187:
	},		},
	...		...
	}</pre~~></code~~>		}</pre>

	{{FIXME}}?		{{FIXME}}?

Flozi: /* Specifications */ data types

2014-10-02T17:04:36Z

Specifications: data types

← Older revision		Revision as of 18:04, 2 October 2014
Line 20:		Line 20:
	= Specifications =		= Specifications =
	Now because of the various graphical modes, and some options being shared, I've split this into sections.		Now because of the various graphical modes, and some options being shared, I've split this into sections.

			==Data Types==
			{{DataTypes}}

	== Options that are always relevant ==		== Options that are always relevant ==
	<code><pre>local mapinfo = {		<code><pre>local mapinfo = {

Enetheru: /* Dynamic */ added example image.

2013-08-02T05:28:17Z

Dynamic: added example image.

← Older revision		Revision as of 06:28, 2 August 2013
Line 103:		Line 103:
	{\| class="wikitable"		{\| class="wikitable"
	\|+ Example		\|+ Example
	\| ~~{{FIXME}}need to place an image here~~		\| [[file:water_dynamic_example.jpg\|400px]]
	\|}</center>		\|}</center>
	<code><pre>local mapinfo = {		<code><pre>local mapinfo = {

Enetheru: /* Reflective and Refractive */ added example image.

2013-08-02T05:24:33Z

Reflective and Refractive: added example image.

@@ Line 119: / Line 119: @@
 == Reflective and Refractive ==
-{{FIXME}}?
+From what i can tell, this mode is basically the same as the reflective mode, except that it distorts(refracts the light) of objects under the surface.
 == Bump Mapped ==

Enetheru: /* Basic */ added example image

2013-08-02T05:13:22Z

Basic: added example image

← Older revision		Revision as of 06:13, 2 August 2013
Line 62:		Line 62:
	{\| class="wikitable"		{\| class="wikitable"
	\|+ Example		\|+ Example
	\| ~~{{FIXME}}need to place an image here~~		\| [[File:Water basic example.jpg\|400px]]
	\|}</center>		\|}</center>
	<code><pre>local mapinfo = {		<code><pre>local mapinfo = {

Enetheru: added infomration about water plane.

2013-08-02T05:10:35Z

added infomration about water plane.

← Older revision		Revision as of 06:10, 2 August 2013
Line 34:		Line 34:

	forceRendering = false,		forceRendering = false,

			planeColor = {0.0, 0.4, 0.0},
	},		},
	...		...
Line 53:		Line 55:

	{{tag\|name=forceRendering\|default=false\|type=bool\|description=If false, and the minimum height of the terrain is above 1.0, then the water will not be drawn.}}		{{tag\|name=forceRendering\|default=false\|type=bool\|description=If false, and the minimum height of the terrain is above 1.0, then the water will not be drawn.}}

			{{tag\|name=planeColor\|default={0.0, 0.4, 0.0}\|type=float3\|description=sets the colour of the horizon water plane, to prevent it from being drawn at all you must comment out this line.}}

	== Basic ==		== Basic ==
Line 131:		Line 135:
	specularPower = 20.0,		specularPower = 20.0,

	~~planeColor = {0.0, 0.4, 0.0},~~

	surfaceColor = {0.75, 0.8, 0.85},		surfaceColor = {0.75, 0.8, 0.85},

Flozi: 1cat

2013-03-20T20:17:22Z

1cat

← Older revision		Revision as of 21:17, 20 March 2013
Line 173:		Line 173:
	* [[Water_Height:_Mapconv_vs._Heightmap\|water height]]		* [[Water_Height:_Mapconv_vs._Heightmap\|water height]]

	[[Category:~~Development]]~~		[[Category:Map Dev]]
	~~[[Category:Mapdev~~]]

Enetheru: cleaned up some more, learned a lot while reading source files and trying to figure out how water works..

2013-02-21T06:29:19Z

cleaned up some more, learned a lot while reading source files and trying to figure out how water works..

Show changes

Enetheru: started figuring out the various aspects of water.. but have to leave now.. will continue later.

2013-02-20T06:42:56Z

started figuring out the various aspects of water.. but have to leave now.. will continue later.

@@ Line 1: / Line 1: @@
 = Water =
 The 'water' engine feature can be used for more than just water, it can be Lava, Slime, and completely invisible for maps in space.
 <center>
 {| class="wikitable"
@@ Line 6: / Line 67: @@
 | {{FIXME}}need to place an image here
 |}</center>
 == mapinfo.lua ==
 <code><pre>local mapinfo = {
@@ Line 76: / Line 136: @@
 {{FIXME}}Discussion on resourcing again.
 === Shore Waves ===
 {{FIXME}}so much to put in here that i cant test and such because my hardware doesn't support it :|
 == The Water Plane ==
-The water plane is always <code>y = 0</code>, anything underneath the water plane is underwater. The terrain is positioned above and below the water plane using its <code>minHeight</code> and <code>maxHeight</code> values(see [[Mapdev:height]]).
+The water plane is a rectangle the same size as the entire map with a position of <code>y = 0</code>, anything underneath the water plane is underwater. The terrain is positioned above and below the water plane using its <code>minHeight</code> and <code>maxHeight</code> values(see [[Mapdev:height]]).
 To derive the exact value of grey on the heightmap that will be at the water plane use:

Enetheru: began page, so much to do..

2012-12-28T05:53:19Z

began page, so much to do..

New page

= Water =
The 'water' engine feature can be used for more than just water, it can be Lava, Slime, and completely invisible for maps in space.
<center>
{| class="wikitable"
|+ Example
| {{FIXME}}need to place an image here
|}</center>
= Specification =
== mapinfo.lua ==
<code><pre>local mapinfo = {
...
tidalStrength = 0,
voidWater = false,
...
water = {
damage = 0.0,

repeatX = 0.0,
repeatY = 0.0,

absorb = {0.0, 0.0, 0.0},
baseColor = {0.0, 0.0, 0.0},
minColor = {0.0, 0.0, 0.0},

ambientFactor = 1.0,
diffuseFactor = 1.0,
specularFactor = 1.0,
specularPower = 20.0,

planeColor = {0.0, 0.4, 0.0},

surfaceColor = {0.75, 0.8, 0.85},
surfaceAlpha = 0.55,
diffuseColor = {1.0, 1.0, 1.0},
specularColor = {0.5, 0.5, 0.5},

fresnelMin = 0.2,
fresnelMax = 0.8,
fresnelPower = 4.0,

reflectionDistortion = 1.0,

blurBase = 2.0,
blurExponent = 1.5,

perlinStartFreq = 8.0,
perlinLacunarity = 3.0,
perlinAmplitude = 0.9,
windSpeed = 1.0, --// does nothing yet

shoreWaves = true,
forceRendering = false,

--// undefined == load them from resources.lua!
--texture = "",
--foamTexture = "",
--normalTexture = "",
--caustics = {
-- "",
-- "",
--},

},
...
}</pre></code>

=== Void Water ===
{{FIXME}} discussion on void water and use cases
<center>
{| class="wikitable"
|+ Example
| {{FIXME}}need to place an image here
|}</center>

=== Tidal Strength ===
{{FIXME}}Discussion on resourcing again.

=== repeatX and repeatY ===

=== Shading ===

=== Shore Waves ===

{{FIXME}}so much to put in here that i cant test and such because my hardware doesn't support it :|

== The Water Plane ==
The water plane is always <code>y = 0</code>, anything underneath the water plane is underwater. The terrain is positioned above and below the water plane using its <code>minHeight</code> and <code>maxHeight</code> values(see [[Mapdev:height]]).

To derive the exact value of grey on the heightmap that will be at the water plane use:
* <code>{{FIXME}}equation</code>
To derive the maxHeight given a grey value and a minheight use:
* <code>{{FIXME}}equation</code>
To derive the minHeight given a grey value and a maxheight use:
* <code>{{FIXME}}equation</code>
To derive the maxHeight and minHeight given a grey value and a total height use:
* <code>{{FIXME}}equation</code>

= Forum Discussions =
* [http://springrts.com/phpbb/viewtopic.php?f=13&t=28264 chockolate rain] map discussion apparrently has soemthing in it i wanted to keep for later.. cant remember though...
* [[Water_Height:_Mapconv_vs._Heightmap|water height]]

[[Category:Development]]
[[Category:Mapdev]]