WaterTileEffectParameters improvement request

[ctrlaltmilk]

I've been tinkering with a custom water effect and it would be very helpful if WaterTileEffectParameters had better documentation on its properties. Most of the effect parameters are undocumented - the specific properties I'd most like information on are:

• specular_lightness
• foam_color
• foam_color_multiplier
• tick_scale
• animation_speed
• animation_scale
• dark_threshold
• reflection_threshold
• specular_threshold
• near_zoom
• far_zoom

[Osmo]

I +1 this request; some of the properties are bizzare
For example, based on my testing, specular_lightness does not control the color of specular highlights, neither does it seem to affect any other color.
Instead, it seems to control the speed at which the water shader oscillates, which is... i simply have no words to describe how confusing this is.