This page has been translated automatically.
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
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
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.

particles_base

A particles_base material is used for particles. This material supports particles animation.

Parameters#

Base#

Animation Specifies if a diffuse texture contains the texture with atlas animation. Enabling this parameter makes the four-component Animation Coordinates parameter available:
  • X, Y values are the atlas size.
  • Z value is the time scale.
  • W value is the Y coordinate of the Attenuation texture.
Diffuse Texture that defines the surface main color.

The texture is 4-channeled (RGBA):
  • RGB values store a color of the texture.
  • The Alpha (A) channel contains the transparency value.
Diffuse Color Color picker to choose the color of the diffuse map.
Diffuse = Yellow
Diffuse = Green
Alpha Test Threshold Threshold for alpha-test particles. If the alpha component is greater than this value, the particle is rendered.
Notice
Available for alpha-test particles only.
Attenuation Attenuation map. A texture to define the color and alpha component change throughout the particle's life time, from left to right.

Attenuation texture used for fire effect

The texture is 4-channeled (RGBA):
  • RGB values store a color of the texture.
  • The Alpha (A) channel contains the transparency value.
An attenuation texture can be represented by a set of textures. By using the 4-th component of the Animation parameter you can specify which texture should be used for the material.

Four attenuation textures in one
Material Mask A bit mask used by decals. If the material mask of the decal material matches the particle material, the decal is projected.
Normal Texture to store information about a surface's normals deviation. Becomes available, if the Normal Map or Refraction parameter is enabled.

The texture is 2-channeled (RG):
  • RG values contain two components of a normal
  • The third component's value is calculated from the given components in run-time
Disable Underwater Rendering Disables rendering of particles underwater.

Normal Map#

Normal map is used to make flat particles look like spatial objects. Enabling this parameter makes available two additional settings:

Refraction#

Refraction specifies if the material should be rendered during the refraction pass. Surfaces will be rendered during this pass only if they are transparent.

Refraction pass is enabled for particles in the center
Refraction pass is disabled for particles in the center

Enabling this state makes the Normal texture in the Base parameters section available.

Refraction has the Scale parameter — a coefficient to scale the refraction area.

  • By the value of 0 there is no refraction of light for the material.
  • The higher the positive value, the more distorted the image behind the refracting material is.
  • Negative values invert the direction of distortion: the lower the negative value, the bigger a distortion is.
Scale = 0.6
Scale = 2

Transparent Blur#

Enables rendering of the transparent blur effect that can be used to create a heat haze effect typical for hot air.

Notice
Rendering -> Transparent -> Blur option must be enabled.

Transparent blur is fine-tuned via two parameters:

Intensity Degree of blurring.
Texture Four-channel texture to create a specific blur pattern:

Soft Interaction#

Allows adjusting interaction of volumetric particles with other objects thus avoiding moire patterns on the objects. It lessens the particles color depending on their position relatively to the object:

  • If the depth value specifies that the particles are in front or behind the object, they are rendered as usual.
  • If the depth value between the cloud and the object is small, the color is smoothly interpolated.

The Interaction parameter is a depth factor that controls the particles color lessening depending on their position relative to the object:

  • Decreasing the value results in rendering in full color of the particles that are positioned far from the objects.
  • By 0 value, the depth value is considered to be infinite and thus no particles are rendered. All of them are interpolated with the environment.
  • Increasing the value results in rendering of more closely positioned particles in full color. The interpolated area lessens.
Soft interaction is disabled
Soft interaction is enabled

Lighting#

Ambient Ambient specifies if the material should be rendered during the ambient light pass. Note that only transparent surfaces will be rendered.
Light Omni Light Omni specifies if the material should be rendered illuminated by the Omni light sources during the shadow maps rendering. Note that only transparent surfaces will be rendered.
Light Proj Light Proj specifies if the material should be rendered illuminated by the Projected light sources during the shadow maps rendering. Note that only transparent surfaces will be rendered.
Light World Light World specifies if the material should be rendered illuminated by the World light sources during the shadow maps rendering. Note that only transparent surfaces will be rendered.
Use Voxel Probe Specifies whether the particle system is affected by lighting baked into Voxel Probes.
Environment Scale Environment Scale is a multiplier for ambient lighting.

Diffuse Scale A coefficient to scale the brightness of the diffuse map. The higher the value, the brighter the diffuse map is.
Diffuse = 0.55
Diffuse = 1.1
Translucent Translucency coefficient that controls the extent of light diffusion inside the particles object. With a higher value, more light can penetrate through particles.

Translucent Depth The coefficient that fine-tunes the depth of the shadow inside the particles volume.

Emission Scale Emission Scale is a multiplier for the material's emission.

Shadows#

Receive Shadows Specifies if polygons, to which the material is applied, receive shadows from omni, projected or cubemap (environment probe) light sources.
Receive World Shadows Specifies if polygons, to which the material is applied, receive shadows from world light sources.
Transparent Shadow Makes shadows look like they are cast by translucent objects.
Notice
This feature is available for transparent materials only.
Lerp Cascades Toggles linear interpolation of shadows cascades on and off. When enabled, transitions between cascades become smoother. However, the option drops performance, because two shadow maps are rendered in the transition parts.
Notice
For this feature to work properly, linear interpolation of shadow cascades should be enabled globally (via Rendering -> Shadows -> Lerp Shadow Cascades).
Filter Mode Filtering mode to be used for shadows from all light sources cast on the material. This mode determines the quality of soft shadows reducing the stair-step effect. Higher quality produces smoother shadows. Available values:
  • Disabled — filtering for shadows is disabled, the stair-step effect is clearly seen at the edges of shadows.
  • Low — low quality
  • Medium — medium quality
  • High — high quality
  • Ultra — ultra quality
Notice
This parameter is similar to the global shadow filtering mode (Settings -> Render -> Shadows), but is used for transparent objects on a per-material basis.
Penumbra Mode Quality mode to be used for rendering penumbra from all light sources cast on the material. This mode enables simulation of real-world shadows by keeping sharp contact shadows closer to the base and softening the farther the shadow stretches away. Higher quality produces softer shadows. Available values:
  • Disabled — penumbra rendering is disabled, shadow edges are crisp and sharp (no shadow softness at all).
  • Low — low quality
  • Medium — medium quality
  • High — high quality
  • Ultra — ultra quality
Notice
This parameter is similar to the global shadow penumbra mode (Settings -> Render -> Shadows), but is used for transparent objects on a per-material basis.
Filter Noise Toggles the use of noise for shadow filtering on and off. This noise is used for smoothing shadows cast on the material and reducing the stair-step effect at the edges of shadows.
Notice
This parameter is similar to the global shadow filter noise (Settings -> Render -> Shadows), but is used for transparent objects on a per-material basis.
Penumbra Noise Toggles the use of noise for penumbra rendering on and off. This noise is used for smoothing soft shadows cast on the material.
Notice
This parameter is similar to the global shadow penumbra noise (Settings -> Render -> Shadows), but is used for transparent objects on a per-material basis.
Softness Multiplier Multiplier for smoothing the edges of shadows cast by particles.
Shadow Threshold Threshold for the alpha component for shadows.
Notice
Not available for opaque particles.
Shadow Offset Fine-tuning of the distance between the shadow and the object that casts this shadow.

Deferred Buffers#

Enabling Deferred Buffers makes the material to be rendered during the deferred pass.

Notice
This parameter is available for transparent particles only.
Deferred Threshold Threshold for the alpha component for the deferred pass. If the alpha component is greater than this value, the particle will be written into the deferred buffer.

Auxiliary#

Auxiliary specifies if the material should be rendered into the auxiliary color buffer to create a custom post-process effect.

Auxiliary Color Color picker to choose an auxiliary color for the Auxiliary rendering pass.
Auxiliary Threshold Threshold for the alpha component for the auxiliary pass. If the alpha component is greater than this value, the particle will be written into the auxiliary buffer.
Last update: 2020-04-10
Build: ()