This page has been translated automatically.
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
FAQ
Программирование
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
CIGI Client Plugin
Rendering-Related Classes
Внимание! Эта версия документация УСТАРЕЛА, поскольку относится к более ранней версии SDK! Пожалуйста, переключитесь на самую актуальную документацию для последней версии SDK.
Внимание! Эта версия документации описывает устаревшую версию SDK, которая больше не поддерживается! Пожалуйста, обновитесь до последней версии SDK.

water_global_base

A water_base material simulates water and other liquids.

The water_global_base material performs quad tessellation of the water surface. But you should take into account that not the whole water surface is tessellated. In fact, we have two part of the water: inner that is tessellated (always under the camera) and outer that is not. Different parameters allows you to specify the distance of tessellated grid under the camera and the rate of decrementing the tessellation factor.

States

In the States tab you can set rendering passes and available options. Enabling some of the states activates additional textures and parameters in the Textures and Parameters tabs respectively.

Material window, States tab.

FieldShoreline States

High Precision

High Precision state enables improved interpolation between the adjacent pixels of the shoreline texture to reduce stepping artifacts. This can be noticed when looking at the waterline separating overwater and underwater.

Notice
This state should be used only when geometry and/or normal states are enabled.
High Precision state disabled.
High Precision state enabled.

Normal

Normal state enables calculation of normals for geometry of shoreline waves. This option significantly reduces performance and can be used in cases, when really large waves are required. Enabling just the geometry state to simulate distortion of the water surface by a shoreline wave is enough in most cases.

Geometry

Geometry state enables rendering of wave geometry of shoreline waves. When this option is disabled the surface of the water remains flat. Switching this option off in cases when wave geometry is hardly noticeable (e.g. a flight simulator) gives a performance gain.

Geometry state disabled.
Geometry state enabled.

Foam

Foam state enables foam rendering for shoreline zones.

Foam state disabled.
Foam state enabled.

FieldSpacer Interaction

FieldSpacer interaction state enables the influence of FieldSpacer object on water object.

FieldHeight Interaction

FieldHeight interaction state enables the influence of FieldHeight object on water object.

FieldShoreline Interaction

FieldShoreline interaction state enables the influence of FieldShoreline object on water object.

Choppy Waves

Choppy waves state provides more realistic wave with sharp crests.

Choppy waves state disabled.
Choppy waves state enabled.

Underwater DOF

Underwater DOf adds an additional blur effect for underwater and overwater splice to make the waterline looks more plausible.

High quality waterline state disabled.
High quality waterline state enabled.

Caustics

Caustics allows you to render light rays refracted by the water surface.

Caustics state disabled.
Caustics state enabled.

Caustics Distortion

Caustics Distortion removes pixelation and makes caustics look smoother. When smoothing is not required, you can disable this option to gain performance.

Caustics Distortion state disabled.
Caustics Distortion state enabled.

Planar Reflection

Planar Reflection allows you to use planar reflections on the water surface instead of SSR. It is better to use it on undisturbed water (0-2 Beaufort).

Notice
Enabling the option activates Planar Map Size and Planar Refleciton parameters.

Map Size

Map Size Map size parameter specifies the size of the planar reflection map: the higher the value, the better the quality is.

Available sizes of the map are:

  • 128 — creates a reflection image with 128x128 resolution.
  • 256 — creates a reflection image with 256x256 resolution.
  • 512 — creates a reflection image with 512x512 resolution.
  • 1024 — creates a reflection image with 1024x1024 resolution.
  • 2048 — creates a reflection image with 2048x2048 resolution.
  • 4096 — creates a reflection image with 4096x4096 resolution.
  • Quart height — creates a reflection image with the resolution height/4 xheight/4, where height is an application window height.
  • Half height — creates a reflection image with the resolution height/2 xheight/2, where height is an application window height.
  • Height — creates a reflection image with the resolution height xheight, where height is an application window height.

Textures

Material window, Textures tab.

Foam

Foam texture specifies the foam on the water. It will be written into the diffuse buffer.

The engine twice samples the foam texture to create plausibility of the real world foam behavior.

The texture is 1-channeled.

Shoreline LUT

Shoreline LUT is a LUT texture used for shoreline wetness effect.

Normal Detail

Normal Detail map stores normal information required to achieve an additional (detail) effect of Normal Mapping. Normal map helps to create ripples (cats-paw effect) on the water surface.

With absolutely white normal map
With ripple-simulated normal map

The texture is 2-channeled:

  1. RG values store two components of a surface normal.
  2. B value is calculated based on the R and G values in run-time.

Depth LUT

Depth LUT is a LUT texture, which shows the color of the bottom. Depending on the depth, the engine chooses the color of the water and multiply it to water generated LUT texture. This generated LUT shows how deep the photon goes through the water to till complete scattering.

The texture is 4-channeled:

  1. RGB values store color.
  2. A value is used for creating "transparent" water near the shore. In other words, it defines the fog density.

Caustics

3D Caustics texture determines the pattern of light rays refracted by the water surface.

The texture is 1-channeled:

  1. R value defines the caustics pattern.

Height

Height texture is used to create a height displacement for waves. By using height texture, the engine creates waves on the water surface. The engine performs triple access to the texture.

The texture is 1-channeled:

  1. R value defines the height of the wave.

Parameters

Geometry Parameters

Max Tessellation Factor

Tessellation factors determine how much to subdivide each patch.

Tessellation factor is set to 1
Tessellation factor is set to 16

Tessellation Exponent

Tessellation Exponent parameter is in charge of rate of tessellation factor changing. It specifies how fast the tessellation will fades from the center point of inner water to outer.

Tessellation Distance

The engine doesn't performs the tessellation of whole water surface because it would significantly affect performance. In fact, we have two parts of the water: inner (always under the camera) and outer. This parameter specifies the size of the inner water grid - the part of the water that will be tessellated.

Procedural Normal Blur

Procedural Normal Blur parameter specifies the ratio of the procedurally generated normals' blurring. The lower the value, the more blurred (hence, more flatten) the water surface will be.

Procedural Normal Weakening

Procedural Normal Weakening parameter specifies the ratio of procedurally generated normal weakening.

Choppiness Force

Choppiness Force parameter specifies the sharpness of the wave crests. If the Choppy Waves is enabled, the engine takes the vertices near the wave crest and move them closer to the crest and recalculate their normals to make them look more plausible. This parameter specifies the force of that contraction.

Choppiness Normal Blur

Choppiness Normal Blur parameter specifies how moved vertices' normals will be blurred.

Choppiness Normal Weakening

Choppiness Normal Weakening parameter sets the weakening of the normals for choppiness.

Waves Animation Parameters

Waves for water_mesh material are created by using the height map. The engine performs sampling from this height map and creates the waves by using simple formula:

Formula
A*H1 + B*H2 + C*H3

In the formula given above, H1, H2, H3 are samplings from height map, A, B, C are Height Scale parameters.

Additional ripples (cats-paw effect) are created by using normal detail map.

Wave 0 UV Transform

This parameter specifies the transformation of the first height map sampling.

First two parameters mean the scale texture coordinates, along the X and Y axes. Third and forth specify the wind direction.

Wave 0 Height Scale

This parameters sets the height scale of the first height map sampling.

Wave 1 UV Transform

This parameter specifies the transformation of the second height map sampling.

First two parameters mean the scale texture coordinates, along the X and Y axes. Third and forth specify the wind direction.

Wave 1 Height Scale

This parameters sets the height scale of the second height map sampling.

Wave 2 UV Transform

This parameter specifies the transformation of the third height map sampling.

First two parameters mean the scale texture coordinates, along the X and Y axes. Third and forth specify the wind direction.

Wave 2 Height Scale

This parameters sets the height scale of the third height map sampling.

Detail 0 UV Transform

This parameter specifies the transformation of the first detail map sampling.

First two numbers mean the, third and forth specify the wind direction.

Detail 0 Intensity

This parameters sets the intensity of the first detail normal map sampling.

Detail 1 UV Transform

This parameter specifies the transformation of the first detail map sampling.

First two numbers mean the, third and forth specify the wind direction.

Detail 1 Intensity

This parameters sets the intensity of the second detail normal map sampling.

Foam Parameters

Patch 0 UV Size

As the engine samples the foam texture twice, this parameter specifies the size of the first foam texture patch.

Patch 0 UV Speed

This parameter sets the speed of the first foam patch.

Patch 1 UV Size

This parameter specifies the size of the second foam texture patch.

Patch 1 UV Speed

This parameter sets the speed of the second foam texture patch.

Wave Contrast

Wave Contrast parameter sets the contrast of foam mask,

Wave Intensity

Wave Intensity parameter specifies the foam intensity on the wave crests.

Shoreline Intensity

Wave Intensity parameter specifies the foam intensity near shores or different objects in water.

Subsurface Scattering Parameters

Color

This parameter specifies the Subsurface Scattering (SSS) color.

Ambient Intensity

Ambient Intensity parameter sets the intensity of the light ray for whole water. It used to simulate SSS for whole water. The lower the value, the faster the ray will dissipate in water.

Intensity Through Waves

Intensity Through Waves parameter sets the intensity of the light ray that goes through the waves. The lower the value, the faster the ray will dissipate in water.

Intensity Around Foam

Intensity Around Foam parameter sets the intensity of the SSS near the foam.

Exponent Around Foam

Exponent Around Foam parameter specifies the rate of intensity around foam parameter changing.

Underwater Parameters

Underwater parameters specifies the underwater part of the water_global_base material.

The final color of the underwater is calculated by this formula:

Final Color Formula
FinalColor = FogColor * SunLighting^(1/FogSunLighting) + FogColor * EnvLighting^(1/FogEnvLighting)

FogColor, FogSunLighting, FogEnvLighting are parameters that you can specify in the material. Other parameters (Sun and Environment lighting) are calculated according to the sun lighting and environment lighting of the scene. In fact, this formula define how sun lighting and environment lighting affect the final underwater color.

Fog Transparency

Fog Transparency parameter specifies the transparency of the underwater fog. The higher the value, the more transparent the underwater fog will be.

Fog Color

Fog Color parameter defines the fog color. Sun and Environment lightings will affect this parameters to create the final underwater fog color.

Fog Lighting Depth

Fog Lighting Depth parameter sets the distance in units, where the light will affect the underwater color. If the camera moves down deeper than the given value there will be no light.

Fog Environment Lighting

Fog Environment Lighting parameter specifies how the environment lighting will affect the final underwater color.

Fog Sun Lighting

Fog Environment Lighting parameter specifies how the environment lighting will affect the final underwater color.

Bottom Color LUT Scale

Bottom Color LUT Scale parameter is a multiplier for the Depth LUT. It will "stretch" the LUT texture length.

Bottom Color LUT Offset

Bottom Color LUT Offset parameter sets the offset of the Depth LUT texture.

Waterline Size

Waterline Size parameter specifies the thickness of the line that divides overwater and underwater.

Other Parameters

Reflection Roughness

Reflection Roughness parameter specifies the environment reflection roughness of the water surface. It helps to tweak the water surface appearance related to the environment.

Reflection Occlusion

Reflection Occlusion parameter specifies an occlusion factor for environment reflections on the water surfaces with negative normals. Using this parameter enables simulation of reflection of waves on the water surface removing too bright areas on waves close to the horizon.

  • By the minimum value of 0, no occlusion is performed for reflections of waves, no matter what normals the water surfaces have.
  • By the higher values, occlusion is performed for reflections on the water surfaces with negative normals that have a certain slope. The higher the value, the less intensive reflections on the surfaces with negative normals.

Reflection Occlusion Slope

Reflection Occlusion Slope parameter specifies a slope of negative normals of water surfaces, at which occlusion is performed for reflections of waves.

Refraction Scale

Refraction Scale parameter sets the scale of the water refraction. The light moves slower in water and faster in air, that's why we see the refraction of object in the water. This parameter specifies the scale of the water refraction.

Planar Reflection

Mask

Mask specifies the viewport mask of the reflection camera.

Distance

Distance from the reflection camera to the object that will be reflected. In other words, the distance equals the distance from camera to the reflective surface plus the distance from object to reflective surface.

Pivot Offset

Pivot offset specifies the position of the pivot point.

Last update: 10.08.2018
Build: ()