This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
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
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.

clouds_base

A clouds_base material is used to create realistic volumetric clouds. It is applied to CloudLayer object.

Prior Knowledge
This article assumes you have prior knowledge of the following topics. Please read them before proceeding:

Common#

Common Group

Layer Type Type of the cloud layer:
  • Infinite - a global layer of clouds spread inifinitely.
  • Defined - a layer of clouds of the specified size (limited to a certain area), this type is used for regional weather.
Layer Size Size of the cloud layer alonx X and Y axes, in units.
Notice
Available only when the Layer Type parameter is set to Defined
Layer Height Determines the height of the cloud layer, in units.
Layer Height = 100
Layer Height = 500
Clouds Shape Type Defines how the shape of the clouds is determined:
  • Coverage Texture - the shape of the clouds is defined by the built-in coverage texture.
  • 3D Texture - the shape of the clouds is defined by a custom 3D texture (can be used to create a cloud of a specific predefined shape).
Notice
Changing the value of this parameter toggles the set of available parameters in this group and in the Geometry group as well, it also determines whether the Geometry group is to be displayed.
Notice
The following four options are available when the Clouds Shape Type is set to Coverage Texture.
Clouds Coverage

An RGB8 texture with the following channels:

Red channel stores a coverage map. It determines cloud density in a horizontal plane.
Notice
For a number of tuning options to work correctly, this map should not contain absolutely black pixels.
Green channel stores a stormcloud map. It determines areas of the coverage map, where storm clouds are located.
Blue channel stores a height map. It determines cloud height for each point of the coverage map.
Notice
Absolutely black color does not correspond to an absolutely flat cloud, it determines a minimum possible cloud thickness for a certain configuration.
Clouds Region Mask A separate single-channel texture to be used to define areas for the layer where the clouds are to be rendered and where they shouldn't (for regional weather). This texture is stretched to fit the region without any tiling.
Notice
This parameter is available when the Clouds Layer Type is set to Defined
Use Coverage Alpha Use the Alpha-channel of the coverage texture as a mask for rendering coverage of the cloud layer. You can use this mask to define areas for the layer where the clouds are to be rendered and where they shouldn't. It serves to reduce tiling of the clouds coverage. You can also use it to make the borders of the layer smoother (for regional weather) or to reduce tiling for infinite cloud layers.
Notice
This option enables the Alpha Size parameter in the Geometry group
Fix Coverage Tiling Determines if reduction of tiling for the clouds coverage texture is enabled. Such tiling becomes noticeable in large-scale worlds when observing clouds at significant distances. It is recommended to enable this state only when the unwanted effect appears. Please use it wisely, as additional texture fetching affects performance. By default the state is disabled.

Notice
The following two options are available when the Clouds Shape Type is set to 3D Texture.
Clouds 3D Texture 3D texture defining a custom shape of clouds for the layer.
Notice
An additional single-channel map is to be used for shadows (see the Clouds Shadow Texture below).
Clouds Shadow Texture A separate single-channel texture to be used to define a custom shape for the shadows from the cloud layer defined by a custom 3D texture. In case of using the coverage texture shadows are defined by its Red-channel. A 3D texture does not contain such information and thus requires an additional map for shadows.
FieldWeather Mask Bitmask that determines interaction with FieldWeather objects.

Geometry#

Geometry Group

Coverage Size Determines the size of the coverage texture.
Coverage Size = 0.3
Coverage Size = 1
Alpha Size Controls tiling of the map stored in the alpha-channel of the Coverage texture.
Coverage Contrast Type Determines the way the Coverage Contrast parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
Coverage Contrast This parameter determines the contrast of the coverage texture and can be used for fine tuning. It also makes it possible to gradually increase cloudiness without changing the coverage texture when simulating weather. The lower the value the more cloudy the sky looks.
Notice
For this parameter to work properly, the coverage texture must not contain absolutely black pixels.
Coverage Contrast = 0.3
Coverage Contrast = 1
Coverage Height Remap Remaps height values stored in the Blue-channel of the coverage texture (spreads them up vertically along layer height). This parameter can be used to tune the heightmap of the cloud layer without editing the coverage texture in a third-party software.
Notice
The following three options are available when the Clouds Shape Type is set to 3D Texture.
3D Texture Threshold Type Determines the way the 3D Texture Threshold parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
3D Texture Threshold Threshold to be used for the values stored in the 3D texture.
3D Texture Threshold Extent Threshold extent coefficient to be used for the values stored in the 3D texture.
Bottom Fade Determines the form of clouds bottom. Lower values make the bottom more flat.
Bottom Fade = 0
Bottom Fade = 0.5
Clouds Density Type Determines the way the Clouds Density parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
Clouds Density Controls density of the clouds which determines visual appearance. This parameter can be used to simulate cirrus clouds. The default value is 1.
Notice
This parameter should only be used when the desired visual appearance cannot be achieved using other parameters. The higher is the cloud density, the higher is the performance. Lower density values can significally reduce performance.
Cloud Density = 0.2
Cloud Density = 0.4
Storm Cloud Factor Intensity of storm clouds coverage that is stored in the Green channel of the Clouds coverage texture.
Storm Cloud Factor = 0
Storm Cloud Factor = 1

Noise#

Noise Group

Notice
This group is available only when the Clouds Shape Type is set to Coverage Texture.
Noise Size Determines noise graininess. The default value is 0.45.
Notice
Higher values reduce performance and may bring up the tiling issue. Recommended range of values is from 0.3 to 1
Noise Size = 0.3
Noise Size = 1
Noise Threshold Type Determines the way the Noise Threshold parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
Noise Threshold Determines the density threshold of cloud formation. The higher the value the rougher the clouds are.
Notice
This parameter should be used only for fine tuning. Significant changes made to this parameter may result in mismatch of cloud shapes and their shadows.
Noise Threshold = 0.07
Noise Threshold = 0.375
Noise Threshold Extent This parameter works together with Noise Threshold parameter and adjusts appearance of clouds making it possible to make clouds softer or rougher for a selected noise threshold.
Notice
This parameter should be used only for fine tuning. Significant changes made to this parameter may result in mismatch of cloud shapes and their shadows.
Noise Threshold Extent = 0.01
Noise Threshold Extent = 0.2
Noise Mip Offset Controls mip levels of the base noise texture in order to reduce blurring at large distances. The recommended range of values is from 0 to 3. Higher values reduce performance.
Noise Falloff The shape of the clouds is defined by a 4-channel 3D noise texture (4 noise gradients are combined). This parameter enables you to control each noise gradient along the height of the layer via a separate curve. It can be used, for example, for fine-tuning of large clouds.
Fix Noise Tiling Enable reduction of tiling caused by the 3D noise, noticeable in large-scale worlds when the clouds are dense. It is recommended to enable this state only when the unwanted effect appears. Please use it wisely, as additional texture fetching affects performance. By default the state is disabled.

Extra Noise#

Extra Noise Group

Use extra noise for cloud formation. This noise controls cutting out fragments of clouds in less dense areas to add more cloud shape variations. You can use this extra noise when the base form and details are insufficient and you need more variations (e.g. for a cloud layer defined by a 3D texture).

Extra Noise Intensity Intensity of the extra noise used for cloud formation (it controls cutting out fragments of clouds in less dense areas to add more cloud shape variations): higher values result in less dense clouds (more cloud volume is cut out).
Extra Noise Size Determines noise graininess. The default value is 0.45.
Notice
Higher values reduce performance and may bring up the tiling issue. Recommended range of values is from 0.3 to 1
Extra Noise Size = 0.3
Extra Noise Size = 1
Extra Noise Threshold Type Determines the way the Extra Noise Threshold parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
Extra Noise Threshold Determines the density threshold of cloud formation. The higher the value the rougher the clouds are.
Notice
This parameter should be used only for fine tuning. Significant changes made to this parameter may result in mismatch of cloud shapes and their shadows.
Noise Threshold = 0.07
Noise Threshold = 0.375
Extra Noise Threshold Extent This parameter works together with Noise Threshold parameter and adjusts appearance of clouds making it possible to make clouds softer or rougher for a selected noise threshold.
Notice
This parameter should be used only for fine tuning. Significant changes made to this parameter may result in mismatch of cloud shapes and their shadows.
Noise Threshold Extent = 0.01
Noise Threshold Extent = 0.2
Extra Noise Mip Offset Controls mip levels of the extra noise texture in order to reduce blurring at large distances. The recommended range of values is from 0 to 3. Higher values reduce performance.
Extra Noise Falloff The shape of the clouds is defined by a 4-channel 3D noise texture (4 noise gradients are combined). This parameter enables you to control each noise gradient along the height of the layer via a separate curve. It can be used, for example, for fine-tuning of large clouds.

Detail#

Detail Group

Detail Intensity Type Determines the way the Detail Intensity parameter is controlled:
  • Const - control the parameter via a slider (the value is constant along the layer height)
  • Curve - control the parameter via a 2d curve (the value changes along the layer height according to the curve)
Detail Intensity Adjusts detail cutout intensity. Details are cut mostly from the bottom of the clouds.
Notice
Thunderclouds are dense and do not have detail cutout. Therefore, they have detail intensity value equal to 0.
Detail Intensity = 0.8
Detail Intensity = 1.4
Detail Noise Size Determines the size of details cutout from the clouds. This parameter is analogous to the Noise size parameter. The lower is the value the larger pieces are cutout.
Detail Noise Size = 0.01
Detail Noise Size = 5
Detail Distortion Intensity Determines the intensity of clouds detail distortion. This parameter is used to control detail turbulence. The higher is the value the stronger is the detail turbulence effect.
Detail Distortion Intensity = 0.5
Detail Distortion Intensity = 4
Detail Distortion Size Determines the scale of clouds detail distortion according to the corresponding texture. This parameter is used to control detail turbulence. The higher is the value the stronger is the detail turbulence effect.
Detail Distortion Size = 0
Detail Distortion Size = 10
Detail Wispy Billowy Gradient Controls the inversion of detail noise. With the default value of 0, the clouds form is as in the detail texture, increasing the value gradually inverts the values from wispy to billowy and from billowy to wispy.

Distortion#

Distorion Group

Distortion Intensity Intensity of distortion of the clouds shape based on the curl noise.
Distortion Size Scaling factor for distortion of the clouds shape based on the curl noise.
Wind Skew Intensity Defines intensity of cloud shape distortion in the direction of the wind (by default higher portions of clouds are affected more than the lower ones).
Wind Skew Height Gradient Defines which portion of the cloud layer height is affected by the wind skew distortion (Wind Skew Intensity parameter above). The value sets the height level starting from which the cloud shape shall be affected by the skew distortion (e.g. 0.5 - means the middle of the layer).

Shading#

Shading Group

Self Shadows This state determines if a cloud layer casts shadows on itself. By default the state is enabled.
Self Shadows enabled.
Self Shadows disabled.
Sun Color By Depth

Color of lighting from the sun depending on how deep the light goes through the cloud.

  • Horizontal axis - light penetration depth.
  • Vertical axis - RGB channel values.
Anisotropy By Density

Higher anisotropy values result in more light passing through the clouds without being scattered in various directions.

The higher is the value the brighter the cloud will be when we look at the sun and the darker it will be when being looked at in the direction of the sun rays (from the sun).

  • Horizontal axis - cloud density.
  • Vertical axis - anisotropy values.
Ambient Color By Density

Color multiplier for ambient lighting depending on the cloud density.

  • Horizontal axis - cloud density.
  • Vertical axis - RGB channel values for ambient lighting color, Alpha - ambient lighting color saturation.
Ambient Occlusion By Coverage

Color multiplier for ambient lighting depending on the brightness of the Coverage texture.

  • Horizontal axis - Coverage texture value.
  • Vertical axis - RGB channel values for Ambient Occlusion, Alpha - lighting color saturation.
Ambient Occlusion By Coverage Falloff

Intensity gradient for the impact of the Ambient Occlusion By Coverage effect along the height of the cloud. Usually used to avoid darkening of ambient lighting at the top of the clouds.

  • Horizontal axis - height of the cloud from the lowest point at the bottom to the highest point at the top.
  • Vertical axis - RGB channel values for the impact of the Ambient Occlusion By Coverage effect.
Sun Intensity Determines intensity of the sun light affecting the clouds (from above). The higher is the value, the more sun lighting affects clouds. This parameter makes it possible to adjust the appearance of clouds by means of correction of sunlight intensity.
Notice
Areas lighted by the sun do not have environment lighting.
Sun intensity = 0
Sun intensity = 1
Sun Attenuation Controls the amount of sun light passing through clouds without changing their density. The higher the value the less light passes through clouds.

Sun Saturation Determines the saturation of the sun light affecting the clouds.

Ambient Intensity Top Determines intensity of ambient lighting of clouds (lighting from above). Analogous to the previous parameter. The higher is the value, the more ambient lighting affects clouds.
Ambient Intensity Bottom Determines intensity of ambient lighting of clouds (lighting from below). The higher is the value, the more ambient lighting affects clouds.
Ambient Intensity = 0 (Ground color set to ff0000)
Ambient Intensity = 1 (Ground color set to ff0000)
Ambient Saturation Controls ambient lighting color saturation.
Ambient Saturation = 0.0
Ambient Saturation = 1.0
Multiscattering Intensity Controls the approximation of light scattering in clouds. A view-dependent effect is created to control shadows on clouds: when clouds are looked on against the sun, shadows are more intensive compared to the side view.

Attenuation Coefficient Controls the rate of opacity growth (alpha channel) with the distance inside the cloud, imitating cloud volume and fixing a break at a certain height appearing in the process of rendering curved cloud layers when viewed from inside the layer.

Haze Gradient Controls the degree of gradual fading of the clouds to the haze depending on the haze parameters.
Haze Gradient = 0.0
Haze Gradient = 4.0

Shadows#

Shadows Group

Receive Shadows This state determines if shadows from an upper cloud layer can be cast on this cloud layer. By default the state is disabled.
Receive Shadows enabled.
Receive Shadows disabled.
Cast Shadows This state determines if a cloud layer casts shadows. By default the state is enabled.
Cast Shadows enabled.
Cast Shadows disabled.
Shadow Intensity Determines the intensity of shadows cast by clouds. This parameter is used for synchronization of visual appearance of clouds with their shadows.
Shadow intensity = 0.8
Shadow intensity = 1
Shadow Contrast Determines the contrast of shadows cast by clouds.
Shadow contrast = 0.3
Shadow contrast = 1.0
Shadow Multiplier Determines darkness of shadows cast by clouds. The lower the value, the darker the shadows are.
Shadow multiplier = 0.3
Shadow multiplier = 1.0
Shadow Subtraction The higher the value, the larger the area under clouds is covered by the shadow. Decreasing the value causes shadows from clouds to be subtracted from the shadow that covers the area under the clouds.
The parameter can be set to the maximum value, for example, when the shadow cast by the clouds doesn't fully cover the area beneath, however, clouds look dense enough.
Shadow subtraction = 0.2
Shadow subtraction = 0.4

Wind#

Wind Group

Wind speed (X axis) Wind speed along X axis (shifts the coverage texture).
Wind speed (Y axis) Wind speed along Y axis (shifts the coverage texture).
No wind
Wind X = 20, Wind Y = 20
Wind speed (Z axis) Wind speed along Z axis (shifts noise).
No wind
Wind Z = 100
Wind Deformation Control dynamics of moving clouds, i.e. how much clouds change their form as they move.

Textures#

Textures

Material Editor, Textures tab.
Last update: 2021-12-13
Build: ()