Getting Started
Migrating to UNIGINE 2.0
C++ API Migration
UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
Usage Examples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins

decal_base

A decal_base material creates coverings for decals.

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

Common Material Settings

The deca_base material has some changes in common settings:

  • Transparent option is not available for Decals, because decals work only with deferred objects.
  • For alpha blending use blend option in States tab.
  • Alpha-test decal can't be rendered in separate buffets, it overwrite all the materials under the decal. It is pretty fast and can be used for roads, for example.
  • Render order option allows you to specify the order of decals.

States

The following options available for the material.

States

Materials editor, States tab.

Options

Detail

Detail activates a set of textures (diffuse, normal, specular) to form a material layer. It is applied for bringing detalization to the material.

Available options are:

  • Skip - disabled.
  • Overlay first - depending on the base diffuse texture color, the base and detail textures colors are either multiplied (for dark color pixels) or screened (for light color pixels), which leads to the contrast increase while preserving highlights and shadows. Grey pixels are not effected at all. The blending is applied to the first UV coordinates of the mesh.
  • Multiply first - the base diffuse texture color is multiplied by the detail texture color, resulting in darker colors. White pixels are not effected at all. The blending is applied to the first UV coordinates of the mesh.

Opacity Map

Opacity map indicates the alpha channel of which texture to use:

  • Main - use the alpha channel of the main (diffuse) texture.
  • Normal - use the alpha channel of the normal map

Distance Fade

Distance Fade enables smooth fading depending on the distance to the surface where decal is projected. It activates Fade Threshold and Fade Power

Angle Threshold

When you enable Angle threshold option, the angle of the surface will have influence of the decal projection. Enabling this option activates Threshold and Angle Power parameter, that allows to modify the angle, when the decal shouldn't be projected.

The angle threshold allows you to increase the slope for projecting overlap material. It can even be rendered on surfaces that face downwards.

Normal Substitute

Normal substitute specifies a rendering mode for normals. By default, normal maps of a base and overlapping material are combined together. with this option enabled, only normals of the overlapping material are used

Blend

The Blend option allows you to select the type of material blending:

  • Noise - similar to alpha test decal, but it can provide a gradient effect.
  • Alpha Blend - alpha blending mode.
  • Overlay - overlay blending.
  • Multiply - multiply blending.
This option allows you to blend certain parameter of the material (diffuse, normal, etc.).

Textures

Textures available for the material. All of the textures fields have set default textures, which can be replaced by your own ones. Availability of some textures depends on the set States values.

Textures

Materials editor, Textures tab.

Base

Base material textures:

  • Diffuse - base material diffuse texture.
  • Normal - base material normal texture.
  • Specular - base material specular texture.
  • Microfiber - base material microfiber texture.

Detail

Detail material textures:

Parameters

Parameters available for the material. All of the parameters have set default values, which can be replaced by your own ones. Availability of some parameters depends on the set States field values.

Materials editor, Parameters tab.

Transform

  • Base - base material coordinates transformation.
  • Detail - detail material coordinates transformation.

Shading

Base Scale Parameters

  • Diffuse - diffuse texture color. A color picker to choose the color of the diffuse map.
  • Specular - specular texture color. A color picker to choose the color of the specular map.
  • Gloss scale - specular texture scale (a coefficient modifying the size of the highlight).
  • Normal - is an intensity of the relief of the normal map.
  • Microfiber - a coefficient to scale the intensity of the microfiber (provided by a microfiber texture). The higher the value, the higher the microfiber texture effect is.
  • Back - a scale of the translucency effect, which permits light to pass through the object, but diffuses it so objects on the opposite side are not clearly visible.

Visibility parameters

  • Diffuse Visible - a parameter that specifies the influence of the diffuse of the decal over the surface material.
  • Specular Visible - a parameter that specifies the influence of the texture specular of the decal over surface material.
  • Gloss Visible - a parameter that specifies the influence of the texture gloss of the decal over the surface material.
  • Microfiber Visible - a parameter that specifies the influence of the base microfiber texture of the decal over the surface material.
  • Translucent Visible - a parameter that specifies the influence of the translucency effect of the decal over the surface material.
  • Normal Visible - a parameter that specifies the influence of the normal texture over the surface material.

Detail

A set of the shading parameters for detail material textures:

Scale Parameters

  • Diffuse - multiplier of the detail color of the surface provided by the detail diffuse texture similar to the base texture Diffuse parameter.
  • Specular - is a color picker to choose the auxiliary specular color for the detail specular texture similar to the base texture Specular parameter..
  • Gloss - a parameter modifying the size of the highlight of the detail texture similar to the base texture Gloss parameter.

Visibility Parameters

  • Diffuse Visible - a parameter that specifies the influence of the detail texture diffuse over the base texture diffuse.
  • Specular Visible - a parameter that specifies the influence of the detail texture specular over the base texture specular.
  • Gloss Visible - a parameter that specifies the influence of the detail texture gloss over the base texture gloss.
  • Normal Visible - a parameter that specifies the influence of the detail normal texture over the surface.
Notice
Detail parameters are present if a Detail option is enabled.

Decal Mask

Decal mask - decal bit-mask. If the decal mask of the decal material matches the surface material, the decal will be projected.

Angle

Angle parameters:

  • Threshold - threshold angle value. A coefficient to scale a threshold angle for projected overlap materials. The lower the value, the bigger area is rendered.
  • Angle Power - Angle fade power.

Fade

Fade parameters:

  • Threshold - threshold fade value.
    Fade threshold =0
    Fade threshold =1
    Fade threshold =2
  • Fade Power - A coefficient to scale a threshold fade for projected overlap materials. The lower the value, the bigger area is rendered.
    Fade power =0
    Fade power =1
    Fade power =2
Last update: 2017-07-03