This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Landscape Tool
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine 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
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Environment

This section describes settings that control environment of the scene (scattering, haze, etc.). You can create some presets and smoothly combine them by specifying the intensity of a preset thus producing new environments.

Environment Settings
Enabled The value indicating if rendering of environment of the scene is enabled. Enabled by default.
Console access: render_environment (API control)
Correct Roughness The correction mode for environment reflections on rough surfaces. Correction modes differ in the number of rays used to create a reflection on a rough surface. One of the following values:
  • Off (by default)
  • Low
  • Medium
  • High
  • Ultra

Console access: render_environment_correct_roughness (API control)
Background Color The background color vector. The Alpha channel of this color sets background transparency: lower alpha channel values produce darker background color. This parameter allows creating colored transparent background instead of rendering an environment cubemap. However, if the environment cubemap is rendered, the background color will always be rendered over the environment.

Console access: render_background_color (API control)
Black background color
Default Background Color
Blue background color
Blue Background

Environment Presets#

The environment cubemap is tweaked in the Rendering panel -> Environment tab. The scattering can have up to 3 separate settings presets that can be blended by the Preset intensity scroll bars.

Presets work as layers: the first preset will overlay the zero one, the second will overlay the first and the zero ones. For example, you can set the zero preset for the clean and clear sky, set the first preset for the cloudy sky and lerp them smoothly.

Scattering LUT Settings#

All the presets settings are identical. The scattering versatility is achieved mostly because of the scattering LUT textures.

Base#

A 2D texture defining the base color of the sky. The use of texture depends on the Scattering mode of the active World light source. If the Sun scattering mode is selected, the texture means the following:

  • Left to right: the position of the Sun above the surface (time of day).
  • Top to down: the gradient of the Sun.

For a World light source in the Moon scattering mode, the rightmost column is used to define the color of the sky.

At the example below, when the Sun's angle is 90 degrees (right in the middle of gradient), the sky's top is blue, the horizon is yellow, the sky below the horizon is brown.

Base LUT Texture

Sampling the Base LUT texture based on the sun angle.

Mie#

A 2D texture (for both the Sun and the Moon) for setting the Mie light (the color of the light around the Sun) to simulate interaction of light with water, dust and other particles in the atmosphere. The texture has two parts for the Sun (the upper part) and the Moon (the lower part) scattering modes.

Mie LUT Texture

The texture is sampled vertically according to the time of day along the horizontal axis.

Sampling the Mie LUT texture based on the sun angle. A black texture is used for the Base LUT for clarity.

The Alpha channel represents the mask for the celestial body texture. At the example below, if a mask has the white upper half, both celestial bodies (Sun and Moon) are visible only above the horizon. Paint the channel black to simulate dense cloudiness without visible celestial bodies.

The Alpha channel of the Mie texture.

The result of using different masks in the Alpha channel.

Light Color#

A 2D texture defining the color of the LightWorld for different times of day. The texture means the following:

  • Top to down: the WorldLight's angle of slope.

The texture has two parts for the Sun (the upper part) and the Moon (the lower part) scattering modes. Left to right texture direction doesn't matter, so you can use the texture 1×512 (width to height) pixels in size.

Light Color LUT Texture

Sampling the Light Color LUT texture based on the sun angle. A black texture is used for the Base and Mie LUTs for clarity.

Environment Settings#

Environment settings are required for creating environment by means of panorama (cubemap).

Texture

A cube map defining the environment image; for example, HDRI environment map or skydome. You can download suitable images from such websites as polyhaven.com.

Notice
We recommend using an HDR or uncompressed EXR image for better shading results. Note that lossy compression types B44, B44A, PIX24, which the EXR format may use, are not supported.
Color The environment color multiplier, where alpha defines the visibility of a cubemap above scattering. This parameter is required when you need to display a sky with a photo texture and dynamic gradients at the same time.
Blur A value defining blurring of the environment.
Rotation X The rotation angle of the environment cubemap around the X axis.
Rotation Y The rotation angle of the environment cubemap around the Y axis.
Rotation Z The rotation angle of the environment cubemap around the Z axis.
Blend Mode The blending mode for the environment cubemap. One of the following values:
  • alpha blend (by default)
  • additive blend
  • multiply
  • overlay

Console access: render_environment_cubemap_blend (API control)

Haze Settings#

Physically based haze


This group of parameters set the atmosphere haze. It automatically uses the color from the scattering LUTs, so objects smoothly fade into the distance without any artifacts.

Haze Settings
Notice
In some cases, the configuration of the default environment presets is not suitable for dense fog simulation and might require some adjustment.
Mode The mode for the haze effect.
  • If Disabled, no haze is applied.
  • The Solid mode uses the solid color from the Color parameter.
  • The Scattering mode uses the color from the sky LUTs is blended with the Color parameter. This value is recommended for better realism: objects will smoothly fade into the distance.
Option #3 is selected by default (see above).
Console access: render_environment_haze (API control)

Gradient Mode The environment haze gradient mode. By using this option, you can make the haze look more realistic for a specific distance range.
  • Short Distance Range — better suitable for near-surface haze
  • Long Distance Range — better suitable for hazy mountains
  • Physically Based — for physically based haze simulation
Option #1 is selected by default (see above).
Console access: render_environment_haze_gradient (API control)
Color The color of the haze. This value can be specified for both the Solid and Scattering haze modes: in the first case, the color will be used as is, in the second case, the color will be blended with the color from the sky LUTs.

Max distance The distance starting at which the haze becomes completely solid, so nothing will be seen behind. For large terrains it is recommended to set this parameter equal to your camera's Far parameter. This is required for distant objects to fade into the distance instead of being cut sharply.
Density The density of the haze.

Physically Based Haze Calculation Parameters#

This group of parameters is used for physically based calculation of the haze gradient.

In most cases there is no need to adjust default haze settings here. However, if you want to change haze color (e.g., make it a bit more bluish) we recommend you doing it via the Color multiplier above. instead of tweaking Color Saturation for sunlight and ambient lighting. As this may cause problems with colors at sunset.

Physically Based Haze Calculation Parameters
Half Visibility Distance Distance at which the visibility comprises 50%. There is no zero-visibility in the real world, so the half-visibility boundary is used to adjust haze distance.
Half Faloff Height Height of the haze density gradient. The higher the value, the longer the haze desity reduces as the height grows, making the transition between the clear sky and haze smoother.
Start Height Reference height value for the two parameters above (Half Visibility Distance and Half Faloff Height).
Ambient Light Intensity Intensity of the impact of ambient lighting on haze (how much ambient lighting affects the haze).
Ambient Color Saturation Intensity of the ambient color's contribution to the haze (how much the haze color is affected).
Sun Light Intensity Intensity of the impact of the sunlight on haze (how much the sunlight affects the haze).
Sun Color Saturation Intensity of the sunlight color's contribution to the haze (how much the haze color is affected).
Notice
"Sunlight color" here does not simply mean the color multiplier of the WorldLight source, but rather the Light Color in the Scattering LUT section above.

Intensity Settings#

Notice
It is recommended to use the default values of the parameters below (if possible) to keep the image realistic.

Intensity Settings
Ambient Intensity of the environment ambient lighting for the given preset. 0 value means no environment ambient lighting for the given preset. The higher the value, the more ambient lighting affects environment. The value can be greater than 1.0 (useful for some dark scenes).

Reflection Intensity of the environment reflection for the given preset. 0 value means no environment reflection for the given preset.

Sky Intensity of the environment sky for the given preset. 0 value means no environment sky for the given preset. If, for example, the sky looks too dark in contrast with lighting from it, you should check exposure and tone mapping settings before changing the environment intensity.

Celestial Bodies Settings#

This group of parameters allows setting up the notable celestial bodies: the Sun and the Moon. By using these parameters, you can set the Sun and the Moon by using textures, adjust its intensity and color multipliers, specify the angular size of the celestial bodies. By default, values of the parameters are set for an observer on the Earth.

Sun A texture that sets the Sun in the sky. On the picture below, the Sun Size is increased to demonstrate how the textures are applied:

Moon A texture that sets the Moon in the sky. On the picture below, Moon Size and Moon Intensity are increased to demonstrate how the textures are applied:

Sun Color Color multiplier for the Sun texture in the RGBA format. By default, the color is white.
Moon Color Color multiplier for the Moon texture in the RGBA format. By default, the color is white.
Sun Size Angular size of the Sun in degrees. The value is set for an observer on the Earth. By default, the size of the Sun is 0.5 degrees as seen from the Earth.
Moon Size Angular size of the Moon in degrees. The value is set for an observer on the Earth. By default, the size of the Moon is 0.5 degrees as seen from the Earth.
Sun Intensity Intensity multiplier for the Sun texture. It allows increasing/reducing brightness of the Sun.

Moon Intensity Intensity multiplier for the Moon texture. It allows increasing/reducing brightness of the Moon.

Last update: 2022-03-10
Build: ()